다음을 통해 공유

User Assigned Identities - Create Or Update

서비스:
Managed Identity
API 버전:
2024-11-30

지정된 구독 및 리소스 그룹에서 ID를 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{resourceName}?api-version=2024-11-30

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
resourceName
 path True

string

ID 리소스의 이름입니다.
subscriptionId
 path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version
 query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
___location True

string

리소스가 있는 지리적 위치
properties.isolationScope

IsolationScope

필요에 따라 ID 할당에 대한 지역별 제한을 구성하는 열거형입니다.
tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

Identity

리소스 'Identity' 업데이트 작업에 성공했습니다.
201 Created

Identity

리소스 'Identity' 만들기 작업에 성공했습니다.
Other Status Codes

CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

IdentityCreate

샘플 요청

PUT https://management.azure.com/subscriptions/12345678-1234-5678-9012-123456789012/resourceGroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/resourceName?api-version=2024-11-30

{
  "___location": "eastus",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

샘플 응답

상태 코드:
200 
{
  "name": "identityName",
  "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
  "id": "/subscriptions/subid/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
  "___location": "eastus",
  "properties": {
    "clientId": "4024ab25-56a8-4370-aea6-6389221caf29",
    "isolationScope": "None",
    "principalId": "25cc773c-7f05-40fc-a104-32d2300754ad",
    "tenantId": "b6c948ef-f6b5-4384-8354-da3a15eca969"
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}
상태 코드:
201 
{
  "name": "identityName",
  "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
  "id": "/subscriptions/subid/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
  "___location": "eastus",
  "properties": {
    "clientId": "4024ab25-56a8-4370-aea6-6389221caf29",
    "isolationScope": "None",
    "principalId": "25cc773c-7f05-40fc-a104-32d2300754ad",
    "tenantId": "b6c948ef-f6b5-4384-8354-da3a15eca969"
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

정의

Name Description
CloudError

ManagedServiceIdentity 서비스의 오류 응답입니다.
CloudErrorBody

ManagedServiceIdentity 서비스의 오류 응답입니다.
createdByType

리소스를 만든 ID의 형식입니다.
Identity

ID 리소스에 대해 설명합니다.
IsolationScope

필요에 따라 ID 할당에 대한 지역별 제한을 구성하는 열거형입니다.
systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

CloudError

Object

ManagedServiceIdentity 서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

오류에 대한 추가 세부 정보 목록입니다.

CloudErrorBody

Object

ManagedServiceIdentity 서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다.
details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.
message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값 Description
User
Application
ManagedIdentity
Key

Identity

Object

ID 리소스에 대해 설명합니다.

Name 형식 Description
id

string (arm-id)

리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
___location

string

리소스가 있는 지리적 위치
name

string

리소스의 이름
properties.clientId

string (uuid)

ID와 연결된 앱의 ID입니다. MSI에서 임의로 생성된 UUID입니다.
properties.isolationScope

IsolationScope

필요에 따라 ID 할당에 대한 지역별 제한을 구성하는 열거형입니다.
properties.principalId

string (uuid)

만든 ID와 연결된 서비스 주체 개체의 ID입니다.
properties.tenantId

string (uuid)

ID가 속한 테넌트 ID입니다.
systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags

object

리소스 태그.
type

string

리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

IsolationScope

열거형

필요에 따라 ID 할당에 대한 지역별 제한을 구성하는 열거형입니다.

값 Description
None
Regional

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID의 형식입니다.
lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.