--- title: 스키마 가져오기 description: schema_id를 사용하여 단일 SCIM 스키마를 가져옵니다. 지원되는 schema_id 값은 urn:ietf:params:scim:schemas:core:2.0:User 및 urn:ietf:params:scim:schemas:core:2.0:Group입니다. breadcrumbs: 문서 > API > 스키마 가져오기 --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/llms.txt). # 스키마 가져오기 ## v2 (latest) | Datadog site | API endpoint | | ----------------- | ----------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scim/Schemas/{schema_id} | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scim/Schemas/{schema_id} | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scim/Schemas/{schema_id} | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/scim/Schemas/{schema_id} | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scim/Schemas/{schema_id} | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scim/Schemas/{schema_id} | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scim/Schemas/{schema_id} | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/scim/Schemas/{schema_id} | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/scim/Schemas/{schema_id} | ### Overview `schema_id`를 사용하여 단일 SCIM 스키마를 가져옵니다. 지원되는 `schema_id` 값은 `urn:ietf:params:scim:schemas:core:2.0:User` 및 `urn:ietf:params:scim:schemas:core:2.0:Group`입니다. This endpoint requires all of the following permissions: - `user_access_invite` - `user_access_manage` ### Arguments #### Path Parameters | Field | Type | Description | | ---------------------- | ------ | --------------------------------- | | schema_id [*required*] | string | The id of the schema to retrieve. | ### Response {% tabs %} {% tab label="200" %} OK {% tabs %} {% tab label="Model" %} Definition of a SCIM schema. | Parent field | Field | Type | Description | | ------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | attributes | [object] | A list of attributes that make up the schema. | | attributes | canonicalValues | [string] | A collection of canonical values. | | attributes | caseExact | boolean | A Boolean value that specifies whether or not a string attribute is case sensitive. | | attributes | description | string | The attribute's human-readable description. | | attributes | multiValued | boolean | A Boolean value indicating an attribute's plurality. | | attributes | mutability | string | A single keyword indicating the circumstances under which the value of the attribute can be (re)defined. | | attributes | name | string | The attribute's name. | | attributes | referenceTypes | [string] | A list of resource types or external resources the reference may refer to. | | attributes | required | boolean | A Boolean value that specifies whether or not the attribute is required. | | attributes | returned | string | A single keyword that indicates when an attribute and associated values are returned in response to a GET request or in response to a PUT, POST, or PATCH request. | | attributes | subAttributes | [object] | A list of sub-attributes for complex attributes. | | subAttributes | canonicalValues | [string] | A collection of canonical values. | | subAttributes | caseExact | boolean | A Boolean value that specifies whether or not a string attribute is case sensitive. | | subAttributes | description | string | The attribute's human-readable description. | | subAttributes | multiValued | boolean | A Boolean value indicating an attribute's plurality. | | subAttributes | mutability | string | A single keyword indicating the circumstances under which the value of the attribute can be (re)defined. | | subAttributes | name | string | The sub-attribute's name. | | subAttributes | referenceTypes | [string] | A list of resource types or external resources the reference may refer to. | | subAttributes | required | boolean | A Boolean value that specifies whether or not the attribute is required. | | subAttributes | returned | string | A single keyword that indicates when an attribute and associated values are returned in response to a GET request or in response to a PUT, POST, or PATCH request. | | subAttributes | type | string | The data type of the attribute. | | subAttributes | uniqueness | string | A single keyword value that specifies how the service provider enforces uniqueness of attribute values. | | attributes | type | string | The data type of the attribute. | | attributes | uniqueness | string | A single keyword value that specifies how the service provider enforces uniqueness of attribute values. | | | description | string | Human-readable description of the schema. | | | id | string | The unique URI of the schema. | | | meta | object | Metadata associated with a SCIM schema. | | meta | location | string | URL identifying the schema. | | meta | resourceType | string | Type of resource. | | | name | string | The human-readable name of the schema. | {% /tab %} {% tab label="Example" %} ```json { "attributes": [ { "canonicalValues": [], "caseExact": false, "description": "string", "multiValued": false, "mutability": "string", "name": "string", "referenceTypes": [], "required": false, "returned": "string", "subAttributes": [ { "canonicalValues": [], "caseExact": false, "description": "string", "multiValued": false, "mutability": "string", "name": "string", "referenceTypes": [], "required": false, "returned": "string", "type": "string", "uniqueness": "string" } ], "type": "string", "uniqueness": "string" } ], "description": "User Schema", "id": "urn:ietf:params:scim:schemas:core:2.0:User", "meta": { "location": "https://app.datadoghq.com/api/v2/scim/Schemas/urn:ietf:params:scim:schemas:core:2.0:User", "resourceType": "Schema" }, "name": "User" } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="404" %} Not Found {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Path parameters export schema_id="CHANGE_ME" # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com export DD_BEARER_TOKEN="" curl -X GET "https://api.${DD_SITE}/api/v2/scim/Schemas/${schema_id}" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ``` {% /tab %} {% /tabs %}