Table of contents

디렉터리 스키마 확장 | Graph API concepts(Graph API 개념)Directory schema extensions | Graph API concepts

Jimaco Brannian|마지막 업데이트: 2018-06-19
|
2 기고자

이 항목에서는 외부 데이터 저장소 없이 디렉터리 개체에 속성을 추가하는 데 사용할 수 있는 Azure AD Graph API의 디렉터리 확장에 대해 알아봅니다.This topic discusses directory extensions in the Azure AD Graph API, which can be used to add properties to directory objects without requiring an external data store.예를 들어 조직에 디렉터리의 각 사용자에 대한 Skype ID를 필요로 하는 LOB(기간 업무) 응용 프로그램이 있는 경우 Graph API를 사용하여 디렉터리의 사용자 개체에 새 skypeId 속성을 등록한 다음 특정 사용자에 대한 값을 새 속성에 기록할 수 있습니다.For example, if an organization has a line of business (LOB) application that requires a Skype Id for each user in the directory, the Graph API can be used to register a new property named skypeId on the directory’s User object, and then write a value to the new property for a specific user.이 항목에서는 디렉터리 확장의 제한 사항, 디렉터리에 디렉터리 확장을 등록하는 방법 및 Graph API에서 디렉터리 확장을 사용하는 방법을 설명합니다.This topic will help you understand the limitations of directory extensions, how they’re registered in a directory, and provide examples of how they’re used in the Graph API.

중요

Azure Active Directory 리소스에 액세스하려면 Azure AD Graph가 아닌 Microsoft Graph를 사용하는 것이 좋습니다.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.우리는 현재 Microsoft Graph 개발에 집중하고 있으며 앞으로 Azure AD Graph API에 대한 개선 작업은 계획이 없습니다.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for Azure AD Graph API.아직까지 Azure AD Graph API가 적합할 수 있는 시나리오는 매우 제한적입니다. 자세한 내용은 Office 개발자 센터의 Microsoft Graph 또는 Azure AD Graph 블로그 게시물을 참조하십시오.There are a very limited number of scenarios for which Azure AD Graph API might still be appropriate; for more information, see the Microsoft Graph or the Azure AD Graph blog post in the Office Dev Center.

확장 데이터 형식 Extension data types

Graph API 버전 1.5 이상을 사용해서만 확장을 등록할 수 있습니다.Extensions can only be registered using Graph API version 1.5 or newer.등록할 수 있는 속성 유형은 다음과 같습니다.The following property types can be registered:

속성 유형Property Type설명Remarks
BinaryBinary최대 256바이트256 bytes maximum.
부울Boolean
DateTimeDateTimeISO 8601 형식으로 지정해야 합니다.Must be specified in ISO 8601 format.UTC에 저장됩니다.Will be stored in UTC.
IntegerInteger32비트 값입니다.32-bit value.
LargeIntegerLargeInteger64비트 값입니다.64-bit value.
문자열String최대 256자256 characters maximum.

위 속성 유형을 등록할 수 있는 디렉터리의 개체는 다음과 같습니다.The property types above can be registered on the following objects in a directory:

확장 등록 방법 이해Understanding how an extension is registered

확장 속성을 디렉터리에 등록하는 방법 및 Azure AD의 승인 모델이 해당 등록에 영향을 주는 방법을 이해해야 합니다.It’s important to understand how an extension property is registered in a directory and how Azure AD’s consent model affects its registration.Azure AD의 응용 프로그램 동의에 대한 자세한 내용은 Azure Active Directory와 응용 프로그램 통합에 있는 동의 프레임워크 개요를 참조하십시오.For more information about application consent in Azure AD, see Overview of the Consent Framework in Integrating Applications with Azure Active Directory.

확장 속성은 개발자 디렉터리 내의 Application 개체에 등록됩니다.Extension properties are registered on an Application object within the developer’s directory.개발자 디렉터리에서 사용자나 관리자가 응용 프로그램을 승인하고 나면 속성이 대상 디렉터리 유형에 추가되어 개발자 디렉터리에서 즉시 액세스할 수 있는 상태가 됩니다.After the application has been consented to by a user or an admin in the developer’s directory, the property is added to the target directory type and becomes immediately accessible in the developer’s directory.다중 테넌트 응용 프로그램의 경우 다른 조직의 사용자나 관리자가 응용 프로그램을 승인하면 해당 조직의 디렉터리 내 대상 디렉터리 유형에서 확장 속성에 즉시 액세스할 수 있게 됩니다.For a multi-tenant application, when the application is granted consent by a user or an admin in another organization, the extension properties become immediately accessible on the target directory type in the other organization’s directory.

조직에서 등록된 확장이 있는 응용 프로그램에 대해 "읽기 전용" 권한을 승인한 경우에도 다른 조직의 디렉터리에서 속성에 계속 액세스할 수 있습니다.If an organization consents to “read only” permissions for an application with registered extensions, the properties will still become accessible in the other organization’s directory.또한 등록된 응용 프로그램뿐 아니라 조직의 승인된 모든 응용 프로그램에서 확장 속성에 액세스할 수 있습니다.Additionally, extension properties are accessible by any consented application in an organization, not just for the application to which they are registered.해당 조직의 승인된 다른 응용 프로그램에서는 충분한 권한이 있는 경우 새 확장 속성에 대한 값을 읽거나 쓸 수 있습니다.Other consented applications in that organization can read or write values for the new extension property if they have sufficient permissions.

응용 프로그램이 삭제되거나 다른 조직의 디렉터리에서 승인이 제거된 경우에는 대상 디렉터리 개체에서 확장 속성에 액세스할 수 없게 됩니다.If the application is deleted or consent is removed in the other organization’s directory, the extension property becomes inaccessible on the target directory object.응용 프로그램에 의해 확장이 삭제되면 대상 디렉터리 개체에서도 해당 확장에 액세스할 수 없게 됩니다.If the extension is deleted by the application, it also becomes inaccessible on the target directory object.다중 테넌트 응용 프로그램에서 승인을 받은 후 추가 확장 속성을 추가한 경우 다른 조직의 디렉터리에서 이러한 속성에 즉시 액세스할 수 있게 됩니다.If a multi-tenant application adds additional extension properties after consent was granted, these properties become immediately accessible in the other organization’s directory.

참고: 개체에 대해 확장 속성 값을 설정했는데 해당 개체 디렉터리에서 이 속성에 액세스할 수 없게 되어도 해당 개체의 확장 속성 값 제한인 100개에는 이 속성이 계속 포함됩니다.Note: If an extension property’s value is set on an object and that property becomes inaccessible in that object’s directory, the property still counts against that object’s limit of 100 extension property values.속성 값을 설정한 후에 고려 대상에서 제거하려면 명시적으로 해당 값을 null로 설정해야 합니다.The only way to remove the property value from consideration once it has been set is to explicitly set it to null.확장 속성에 액세스할 수 없는 경우에는 이와 같이 설정할 수 없습니다.You cannot do this if the extension property is inaccessible.

시나리오 예Example scenario

시나리오: Litware는 다른 조직에서 사용할 SaaS 응용 프로그램을 개발한 ISV(Independent Software Vendor)입니다. 이 응용 프로그램을 사용하려면 사용자 개체에 skypeId라는 확장 속성이 있어야 합니다.Consider the following scenario: Litware is an independent software vendor (ISV) that has developed a SaaS application for other organizations to use, and this application requires an extension property named skypeId on a User object.Litware는 먼저 자체 디렉터리에 응용 프로그램을 등록한 다음 Graph API를 호출하여 Application 개체에 확장 속성을 등록합니다. 그러면 Litware의 디렉터리 내 User 개체에서 이 속성에 액세스할 수 있게 됩니다.Litware first registers the application in its own directory, and then the Graph API is called to register the extension property on the Application object, which makes the property accessible on User objects in Litware’s directory.마지막으로 Litware는 다른 조직에서 사용할 수 있도록 이 응용 프로그램을 다중 테넌트 가능하게 설정합니다.Finally, Litware makes the application multi-tenant capable so that it can be used in other organizations.

Contoso에서 Litware의 SaaS 응용 프로그램을 사용하려고 합니다. 따라서 Contoso의 사용자 또는 관리자는 응용 프로그램을 승인해야 합니다.Contoso wants to use Litware’s SaaS application, so a user or administrator in Contoso consents to the application.승인 시 응용 프로그램이 Contoso 디렉터리에 등록되고 Litware에서 해당 응용 프로그램에 대해 등록한 확장 속성을 Contoso 디렉터리에서 즉시 사용할 수 있게 됩니다.Upon consent, the application is registered in Contoso’s directory and the extension properties registered for the application by Litware immediately become available in the Contoso directory.Litware에서 User 개체에 대한 skypeId 확장 속성을 응용 프로그램에 대해 등록했으므로 Contoso 디렉터리의 User 개체에서 속성에 액세스할 수 있게 됩니다.Since the skypeId extension property for a User object was registered by Litware on the application, the property becomes accessible on User objects in Contoso’s directory.그러면 Litware의 응용 프로그램이나 Contoso 디렉터리에 포함된 기타 승인된 응용 프로그램이 Contoso 디렉터리에서 해당 응용 프로그램에 대해 구성된 권한에 따라 새 속성에 액세스할 수 있습니다.Litware’s application or other consented applications in Contoso’s directory can now access the new property according to the permissions configured for that application in Contoso’s directory.즉, 해당 응용 프로그램은 권한에 따라 디렉터리의 사용자 한 명 이상에 대해 해당 확장 속성의 값을 쓸 수 있습니다.This means that applications, according to their permissions, may write a value for that extension property on one or more users in the directory.skypeId 값이 작성된 사용자의 경우에만 자신의 User 개체에 대해 해당 속성이 반환됩니다.Only users for which a skypeId value has been written will return that property on their User object.skypeId 속성이 null로 설정될 때까지는 이 방식이 사용되며, 그 후에는 해당 사용자의 사용자 개체가 더 이상 속성을 반환하지 않습니다.This will be the case until the skypeId property is set to null, after which time the User object for that user will no longer return the property.

디렉터리 확장에 대한 샘플 REST 요청Sample REST requests for directory extensions

다음 예제 요청에서는 디렉터리에서 확장을 보고, 쓰고, 읽고, 필터링하고, 등록 취소하는 방법을 보여 줍니다.The following sample requests show you how to register, view, write, read, filter, and unregister extensions in your directory.<applicationObjectId> 자리 표시자를 등록된 응용 프로그램의 개체 ID로 바꿉니다.Replace the <applicationObjectId> placeholder with your registered application’s Object ID.다음과 같은 방식으로 이 값을 가져올 수 있습니다.You can get this value in the following way:

  1. https://graphexplorer.cloudapp.net/으로 이동하여 오른쪽 상단에 있는 Sign In 링크를 클릭한 다음, 조직의 디렉터리 내 관리자 계정의 자격 증명을 사용하여 로그인합니다.Go to https://graphexplorer.cloudapp.net/, click the Sign In link at the top-right corner, and then sign in using the credentials for an administrator account in your organization’s directory.
  2. 로그인한 후에 GET 단추 옆의 리소스 텍스트 상자에서 URL을 클릭하고 applications/로 끝나는 URL을 선택한 후에 GET 또는 Enter 키를 클릭합니다.After you have signed in, click the URL in the resource text box (next to the GET button) and select the URL that ends in applications/ then click GET or click the enter key.
  3. 결과에서 원하는 응용 프로그램 항목을 찾아 다음과 같이 해당 objectId 값을 복사합니다. "objectId": "269fc2f7-6420-4ea4-be90-9e1f93a87a64"Find the desired application entry from the results, and then copy its objectId value, such as the following: "objectId": "269fc2f7-6420-4ea4-be90-9e1f93a87a64"

이 섹션에서는 다음 작업을 위한 샘플 요청을 제공합니다.In this section, there are sample requests for the following operations:

확장 속성을 사용하는 전체 샘플은 Github의 Azure AD 샘플을 참조하십시오.For full samples that use extension properties, see the following samples in the Azure AD samples on Github:

확장 등록 Register an extension

다음 샘플 요청은 원하는 Application 개체에 extensionProperty를 만듭니다.The following sample request creates an extensionProperty on the desired Application object.

요청 형식Request format

POST https://graph.windows.net/contoso.onmicrosoft.com/applications/<applicationObjectId>/extensionProperties?api-version=1.5 HTTP/1.1

{
    "name": "<extensionPropertyName>",
    "dataType": "<String or Binary>",
    "targetObjects": [
        "<DirectoryObject>"
    ]
}

샘플 요청Sample request

POST https://graph.windows.net/contoso.onmicrosoft.com/applications/269fc2f7-6420-4ea4-be90-9e1f93a87a64/extensionProperties?api-version=1.5 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Content-Type: application/json
Host: graph.windows.net
Content-Length: 104

{
    "name": "skypeId",
    "dataType": "String",
    "targetObjects": [
        "User"
    ]
}

작업에 성공하면 대상 유형의 값을 쓰는 데 사용할 수 있는 정규화된 확장 속성 이름과 함께 HTTP 201 Created 상태 코드가 반환됩니다.If the operation was successful, it will return an HTTP 201 Created status code along with the fully-qualified extension property name, which can be used for writing values to the target type.

샘플 응답Sample response

HTTP/1.1 201 Created
...

{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/Microsoft.WindowsAzure.ActiveDirectory.ExtensionProperty/@Element",
    "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.ExtensionProperty",
    "objectType": "ExtensionProperty",
    "objectId": "dc893d45-a75b-4ccf-9b92-ce7d80922aa7",
    "name": "extension_ab603c56068041afb2f6832e2a17e237_skypeId",
    "dataType": "String",
    "targetObjects": [
        "User"
    ]
}

등록된 확장 보기 View registered extensions

다음 샘플 요청은 Application 개체에 등록된 확장을 가져옵니다.The following sample request gets the extensions that are registered on your Application object.

요청 형식Request format

GET https://graph.windows.net/contoso.onmicrosoft.com/applications/<applicationObjectId>/extensionProperties?api-version=1.5 HTTP/1.1

샘플 요청Sample request

GET https://graph.windows.net/contoso.onmicrosoft.com/applications/269fc2f7-6420-4ea4-be90-9e1f93a87a64/extensionProperties?api-version=1.5 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Host: graph.windows.net

작업에 성공하면 응용 프로그램 개체에 등록된 각 확장 속성에 대한 모든 정보와 함께 HTTP 200 확인 상태 코드가 반환됩니다.If the operation was successful, it will return an HTTP 200 OK status code along with all the information about each extension property registered on your Application object.

샘플 응답Sample response

HTTP/1.1 200 OK
...

{
    "odata.metadata": "https://graph.windows.net/contoso.onmicrosoft.com/$metadata#directoryObjects/Microsoft.WindowsAzure.ActiveDirectory.ExtensionProperty",
    "value": [
        {
            "odata.type": "Microsoft.WindowsAzure.ActiveDirectory.ExtensionProperty",
            "objectType": "ExtensionProperty",
            "objectId": "dc893d45-a75b-4ccf-9b92-ce7d80922aa7",
            "name": "extension_ab603c56068041afb2f6832e2a17e237_skypeId",
            "dataType": "String",
            "targetObjects": [
                "User"
            ]
        }
    ]
}

확장 값 쓰기 Write an extension value

다음 샘플 요청은 User 개체의 *skypeId^ 확장 속성에 확장 값을 기록합니다.The following sample request writes an extension value for the *skypeId^ extension property on a User object.

요청 형식Request format

PATCH https://graph.windows.net/contoso.onmicrosoft.com/users/username@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1

{
    "<extensionPropertyName>": <value>
}

샘플 요청Sample request

PATCH https://graph.windows.net/contoso.onmicrosoft.com/users/jim@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Content-Type: application/json
Host: graph.windows.net
Content-Length: 65

{
    "extension_ab603c56068041afb2f6832e2a17e237_skypeId": "jimbob.skype"
}

작업에 성공하면 HTTP 204 No Content 상태 코드가 반환됩니다.If the operation was successful, it will return a HTTP 204 No Content status code.

샘플 응답Sample response

HTTP/1.1 204 No Content

개체에 대한 쓰기 시도가 확장 값 제한인 100회를 초과하면 오류 코드가 "Directory_ResourceSizeExceeded"인 HTTP 403 사용할 수 없음 응답과 “개체의 크기 제한이 초과되었습니다.If the attempted write surpasses the 100 extension value limit for the object, it will return an HTTP 403 Forbidden response with an error code of “Directory_ResourceSizeExceeded” and the following message: “The size of the object has exceeded its limit.값 수를 줄인 후에 요청을 다시 시도하세요."라는 메시지를 반환합니다.Please reduce the number of values and retry your request”.

확장 값 제거 Remove an extension value

다음 샘플 요청은 값을 null로 설정하여 User 개체에서 이전에 skypeId 확장 속성에 대해 설정된 확장 값을 제거합니다.The following sample request removes an extension value that was previously set for the skypeId extension property on a User object by setting the value to null.

요청 형식Request format

PATCH https://graph.windows.net/contoso.onmicrosoft.com/users/username@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1

{
    "<extensionPropertyName>": null
}

샘플 요청Sample request

PATCH https://graph.windows.net/contoso.onmicrosoft.com/users/jim@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Content-Type: application/json
Host: graph.windows.net
Content-Length: 65

{
    "extension_ab603c56068041afb2f6832e2a17e237_skypeId": null
}

작업에 성공하면 HTTP 204 No Content 상태 코드가 반환됩니다.If the operation was successful, it will return a HTTP 204 No Content status code.

샘플 응답Sample response

HTTP/1.1 204 No Content

확장 값 읽기 Read an extension value

다음 예제 요청은 사용자에 대한 간단한 GET 작업을 수행하며, 표준 속성 값 및 새 확장 속성 값을 반환합니다.The following sample request performs a simple GET operation on the user, which will return the standard property values as well as the new extension property value.

요청 형식Request format

GET https://graph.windows.net/contoso.onmicrosoft.com/users/username@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1

샘플 요청Sample request

GET https://graph.windows.net/contoso.onmicrosoft.com/users/jim@contoso.onmicrosoft.com?api-version=1.5 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Host: graph.windows.net

작업에 성공하면 새 확장 속성 값과 함께 HTTP 200 OK 상태 코드가 반환됩니다(간단하게 나타내기 위해 많은 사용자 속성이 예제 응답에서 제거됨).If the operation was successful, it will return an HTTP 200 OK status code along with the new extension property value (many user properties have been removed from the sample response for brevity).

샘플 응답Sample response

HTTP/1.1 200 OK

{
    ...
    "usageLocation": null,
    "userPrincipalName": "Jim@contoso.onmicrosoft.com",
    "userType": "Member"
    "extension_ab603c56068041afb2f6832e2a17e237_skypeId": "jimbob.skype"
}

확장 값 필터링 Filter an extension value

다음 예제 요청은 지정된 확장 속성 값으로 사용자를 필터링합니다.The following sample request filters the users by the specified extension property value.

참고: 확장에 대한 접두사 검색은 문자열 검색의 경우 71자, 이진 확장 검색의 경우 207자로 제한됩니다.Note: Prefix searches on extensions are limited to 71 characters for string searches and 207 bytes for searches on binary extensions.

요청 형식Request format

GET https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=1.5&$filter=<extensionName>%20eq%20'<value>' HTTP/1.1

샘플 요청Sample request

GET https://graph.windows.net/contoso.onmicrosoft.com/users?api-version=1.5&$filter=extension_ab603c56068041afb2f6832e2a17e237_skypeId%20eq%20'jimbob.skype' HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Host: graph.windows.net

작업에 성공하면 결과 사용자 개체와 함께 HTTP 200 OK 상태 코드가 반환됩니다.If the operation was successful, it will return an HTTP 200 OK status code, along with the resulting user object.

샘플 응답Sample response

HTTP/1.1 200 OK

{
    ...
    "usageLocation": null,
    "userPrincipalName": "Jim@contoso.onmicrosoft.com",
    "userType": "Member"
    "extension_ab603c56068041afb2f6832e2a17e237_skypeId": "jimbob.skype"
}

확장 등록 취소 Unregister an extension

다음 예제 요청은 확장 개체 ID에 대해 DELETE 작업을 수행하여 확장 속성의 등록을 취소합니다.The following sample request unregisters an extension property by performing a DELETE operation on the extension object ID.

요청 형식Request format

DELETE https://graph.windows.net/contoso.onmicrosoft.com/applications/<applicationObjectId>/extensionProperties/<extensionObjectId>?api-version=1.5 HTTP/1.1

샘플 요청Sample request

DELETE https://graph.windows.net/contoso.onmicrosoft.com/applications/269fc2f7-6420-4ea4-be90-9e1f93a87a64/extensionProperties/dc893d45-a75b-4ccf-9b92-ce7d80922aa7?api-version=1.5 HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Qi...r6Xh5KVA
Host: graph.windows.net

작업에 성공하면 HTTP 204 No Content 상태 코드가 반환되고 응용 프로그램에서 확장 속성의 등록이 취소됩니다.If the operation was successful, it will return an HTTP 204 No Content status code, and the extension property will be unregistered on the application.

샘플 응답Sample response

HTTP/1.1 204 No Content

확장 동작 및 제한 Extension behavior and limitations

디렉터리의 확장 속성에는 다음과 같은 동작 및 제한이 적용됩니다.The following behavior and limitations apply to extension properties in a directory:

  • 응용 프로그램에 대해 등록된 확장 속성은 디렉터리 사용자 또는 관리자가 해당 응용 프로그램을 승인하면 디렉터리에서 사용할 수 있게 됩니다.Extension properties registered for an application become available in a directory when a directory user or admin consents for the application.

  • 디렉터리에서 확장 속성을 사용할 수 있게 되면 승인된 응용 프로그램이 디렉터리 내의 해당 응용 프로그램 권한에 따라 이 속성이 적용되는 개체에 대해 해당 확장 속성의 값을 읽거나 쓸 수 있습니다.After an extension property becomes available in a directory, any consented application may read or write a value for that extension property for any of the objects for which that property applies according to that application’s permissions in the directory.확장 속성이 적용되는 개체는 targetObjects 속성에서 지정됩니다.The objects for which the extension property applies are specified in the targetObjects property.

  • 디렉터리의 특정 개체에 대해 확장 속성 값을 100개까지 기록할 수 있습니다.A maximum of 100 extension property values may be written on a specific object in a directory.예를 들어 디렉터리의 사용자에 대해 다른 확장 속성 값이 기록되지 않았다고 가정할 때 응용 프로그램이 user1에 대해 확장 속성 값을 기록하면 나머지 99개 확장 속성의 값은 해당 응용 프로그램이나 디렉터리 내의 적합한 권한이 있는 다른 응용 프로그램이 기록할 수 있습니다. 그러나 디렉터리의 다른 사용자에 대해서도 확장 속성 값을 100개까지 기록할 수 있습니다.For example, assuming no other extension property values have been written on any user in a directory, if an application writes an extension property value to user1, then values for 99 other extension properties may be written to user1 by that application or another application with appropriate permissions in the directory; however, other users in the directory will still be able to have up to 100 extension property values written to them.

  • 응용 프로그램이 확장 속성 값 100개가 이미 설정된 개체에 대해 추가 확장 속성 값을 설정하려고 하면 Graph API에서는 오류 코드가 "Directory_ResourceSizeExceeded"인 403 사용할 수 없음 응답과 “개체의 크기 제한이 초과되었습니다.If an application tries to set a value for an additional extension property on an object for which 100 extension property values have already been set, Graph API returns a 403 Forbidden response with an error code of “Directory_ResourceSizeExceeded” and the following message: “The size of the object has exceeded its limit.값 수를 줄인 후에 요청을 다시 시도하세요."라는 메시지를 반환합니다.Please reduce the number of values and retry your request”.

  • 개발자가 응용 프로그램에서 확장 속성을 등록 취소(삭제)하면 개발자 디렉터리와 응용 프로그램이 승인된 디렉터리에서 해당 확장 속성이 즉시 액세스할 수 없는 상태가 됩니다.If a developer unregisters (deletes) an extension property from an application, that extension property immediately becomes inaccessible in the developer directory and also in directories for which the application has been granted consent.

  • 개발자 디렉터리에서 응용 프로그램을 제거하면 개발자 디렉터리와 응용 프로그램이 승인된 디렉터리에서 해당 응용 프로그램에 등록된 모든 확장 속성이 즉시 액세스할 수 없는 상태가 됩니다.If the application is removed from the developer directory, all extension properties registered to that application immediately become inaccessible in the developer directory and in directories in which that application has been granted consent.

  • 디렉터리에서 승인된 다중 테넌트 응용 프로그램이 나중에 해당 디렉터리에서 등록 취소(제거)되면(예: 관리자가 Azure 관리 포털을 통해 등록 취소/제거함) 해당 디렉터리에서 이 응용 프로그램에 등록된 모든 확장 속성이 즉시 액세스할 수 없는 상태가 됩니다.If an multi-tenant application has been granted consent in a directory and that application is later unregistered (removed) from that directory -- for example, by an administrator using the azure management portal -- then any extension properties registered on that application immediately become inaccessible in that directory.

  • 확장 속성 값은 명시적으로 null로 설정해야 디렉터리 개체에서 제거할 수 있습니다.An extension property value must be explicitly set to null in order to be removed from a directory object.디렉터리 개체에 대해 확장 속성 값을 설정했는데 위에서 설명한 이유로 인해 디렉터리에서 해당 확장 속성에 액세스할 수 없게 되면 해당 디렉터리 개체에 대해 확장 속성이 더 이상 표시되지 않습니다.If an extension property value is set on a directory object and that extension property becomes inaccessible in the directory for any of the reasons cited above, then the extension property will no longer be visible on that directory object.그러나 해당 개체의 확장 속성 값 제한인 100개에는 이 속성이 계속 포함됩니다.It will, however, still count against the 100 extension property value limit for that object.경우에 따라 응용 프로그램을 다시 승인하는 등의 방법을 통해 확장 속성을 다시 사용할 수 있게 될 때까지는 읽기 또는 쓰기를 위해 값에 액세스할 수 없습니다.Until the availability of the extension property is restored -- for example, in some cases, by consenting to the application again -- the value will not be accessible for either read or write.

추가 리소스Additional resources

© 2018 Microsoft