CIAM Tenants - Get
Obtenha o recurso de locatário do Azure AD para clientes.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureActiveDirectory/ciamDirectories/{resourceName}?api-version=2023-05-17-preview
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
O nome do grupo de recursos. |
|
resource
|
path | True |
string maxLength: 26pattern: ^[a-zA-Z0-9]{1,26} |
O subdomínio inicial do locatário. |
|
subscription
|
path | True |
string |
Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço. |
|
api-version
|
query | True |
string |
Versão da API a ser usada com a solicitação do cliente. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Recurso de locatário do Azure AD para clientes recuperado com êxito. |
|
| Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Exemplos
Get_CIAM_tenant
Solicitação de exemplo
GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/contosoResourceGroup/providers/Microsoft.AzureActiveDirectory/ciamDirectories/contoso?api-version=2023-05-17-preview
Resposta de exemplo
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/contosoResourceGroup/providers/Microsoft.AzureActiveDirectory/ciamDirectories/contoso",
"name": "contoso",
"type": "Microsoft.AzureActiveDirectory/ciamDirectories",
"location": "United States",
"sku": {
"name": "Standard",
"tier": "A0"
},
"properties": {
"provisioningState": "Succeeded",
"createTenantProperties": {
"displayName": "Contoso",
"countryCode": "US"
},
"billingConfig": {
"billingType": "MAU",
"effectiveStartDateUtc": "1/1/0001 12:00:00 AM"
},
"domainName": "contoso.onmicrosoft.com",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"tags": null,
"systemData": {
"createdBy": "contosoAdmin@onmicrosoft.com",
"createdByType": "User",
"createdAt": "2020-02-03T01:01:01.1075056Z",
"lastModifiedBy": "contosoAdmin@onmicrosoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-02-04T01:01:01.1075056Z"
}
}
Definições
| Nome | Description |
|---|---|
|
ciam |
O tipo de cobrança. Será MAU para todos os novos clientes. Não será possível alterar se o valor for 'MAU'. Saiba mais sobre a cobrança do Azure AD para clientes no aka.ms/b2cBilling. |
| CIAMResourceSKU |
Propriedades de SKU do locatário do Azure AD para clientes. Saiba mais sobre a cobrança do Azure AD para clientes em https://aka.ms/ciambilling. |
|
CIAMResource |
O nome da SKU para o locatário. |
|
CIAMResource |
A camada do locatário. |
|
CIAMTenant |
O recurso do Azure AD para clientes. |
|
ciam |
O tipo do recurso de locatário do Azure AD para clientes. |
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Provisioning |
Estado de provisionamento |
|
system |
Metadados relativos à criação e última modificação do recurso. |
ciamBillingType
O tipo de cobrança. Será MAU para todos os novos clientes. Não será possível alterar se o valor for 'MAU'. Saiba mais sobre a cobrança do Azure AD para clientes no aka.ms/b2cBilling.
| Valor | Description |
|---|---|
| MAU |
O uso do Azure AD para clientes é cobrado em uma assinatura vinculada do Azure e usa um modelo de cobrança de MAU (usuários ativos mensais). |
CIAMResourceSKU
Propriedades de SKU do locatário do Azure AD para clientes. Saiba mais sobre a cobrança do Azure AD para clientes em https://aka.ms/ciambilling.
| Nome | Tipo | Description |
|---|---|---|
| name |
O nome da SKU para o locatário. |
|
| tier |
A camada do locatário. |
CIAMResourceSKUName
O nome da SKU para o locatário.
| Valor | Description |
|---|---|
| Standard | |
| PremiumP1 | |
| PremiumP2 |
CIAMResourceSKUTier
A camada do locatário.
| Valor | Description |
|---|---|
| A0 |
A camada de SKU usada para todos os locatários do Azure AD para clientes. |
CIAMTenantResource
O recurso do Azure AD para clientes.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
Um identificador que representa o recurso de locatário do Azure AD para clientes. |
| location |
string |
O local no qual o recurso está hospedado e os dados residem. Pode ser um dos "Estados Unidos", "Europa", "Pacífico Asiático" ou "Austrália". Consulte esta documentação para obter mais informações. |
| name |
string |
O nome do recurso de locatário do Azure AD para clientes. |
| properties.billingConfig.billingType |
O tipo de cobrança. Será MAU para todos os novos clientes. Não será possível alterar se o valor for 'MAU'. Saiba mais sobre a cobrança do Azure AD para clientes no aka.ms/b2cBilling. |
|
| properties.billingConfig.effectiveStartDateUtc |
string |
Os dados dos quais o tipo de cobrança entrou em vigor |
| properties.createTenantProperties.countryCode |
string |
Código do país do locatário do Azure (por exemplo, 'EUA'). Consulte https://aka.ms/ciam-data-location para ver códigos de país válidos e locais de residência de dados correspondentes. Se você não vir um código de país em um local de residência de dados válido, escolha um na lista. |
| properties.createTenantProperties.displayName |
string |
O nome de exibição do locatário do Azure AD para clientes. |
| properties.domainName |
string |
O nome de domínio do locatário |
| properties.provisioningState |
Estado de provisionamento |
|
| properties.tenantId |
string |
Um identificador do locatário do Azure AD para clientes. |
| sku |
Propriedades de SKU do locatário do Azure AD para clientes. Saiba mais sobre a cobrança do Azure AD para clientes em https://aka.ms/ciambilling. |
|
| systemData |
Metadados relativos à criação e última modificação do recurso. |
|
| tags |
object |
Marcas de recurso |
| type |
O tipo do recurso de locatário do Azure AD para clientes. |
ciamTypeValue
O tipo do recurso de locatário do Azure AD para clientes.
| Valor | Description |
|---|---|
| Microsoft.AzureActiveDirectory/ciamDirectories |
O tipo de recurso para o recurso de locatário do Azure AD para clientes. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
ProvisioningState
Estado de provisionamento
| Valor | Description |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Provisioning | |
| Deleting | |
| Deleted |
systemData
Metadados relativos à criação e última modificação do recurso.
| Nome | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
| createdBy |
string |
A identidade que criou o recurso. |
| createdByType |
O tipo de identidade que criou o recurso. |
|
| lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
| lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
| lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |