Cloud Service Roles - Get

Serviço:

Compute

Versão da API:

2024-11-04

Obtém uma função de um serviço de nuvem.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/cloudServices/{cloudServiceName}/roles/{roleName}?api-version=2024-11-04

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
cloudServiceName	path	True	string	Nome do serviço de nuvem.
resourceGroupName	path	True	string	Nome do grupo de recursos.
roleName	path	True	string	Nome da função.
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Respostas

Name	Tipo	Description
200 OK	CloudServiceRole	OK
Other Status Codes	CloudError	Erro

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Get Cloud Service Role

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}/roles/{role-name}?api-version=2024-11-04

Resposta da amostra

Código de estado:

200

{
  "name": "{role-name}",
  "id": "/subscriptions/{subscription-id}/resourceGroups/ConstosoRG/providers/Microsoft.Compute/cloudServices/{cs-name}/roles/{role-name}",
  "type": "Microsoft.Compute/cloudServices/roles",
  "location": "eastus2euap",
  "sku": {
    "name": "Standard_D1_v2",
    "tier": "Standard",
    "capacity": 2
  },
  "properties": {
    "uniqueId": "b03bc269-766b-4921-b91a-7dffaae4d03b:{role-name}"
  }
}

Definições

Name	Description
ApiError	Erro de api.
ApiErrorBase	Base de erro da api.
CloudError	Uma resposta de erro do serviço de computação.
CloudServiceRole	Descreve uma função do serviço de nuvem.
CloudServiceRoleProperties	As propriedades da função de serviço de nuvem.
CloudServiceRoleSku	Descreve a função de serviço de nuvem sku.
InnerError	Detalhes do erro interno.

ApiError

Object

Erro de api.

Name	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro Api
innererror	InnerError	O erro interno da Api
message	string	A mensagem de erro.
target	string	O alvo do erro específico.

ApiErrorBase

Object

Base de erro da api.

Name	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O alvo do erro específico.

CloudError

Object

Uma resposta de erro do serviço de computação.

Name	Tipo	Description
error	ApiError	Erro de api.

CloudServiceRole

Object

Descreve uma função do serviço de nuvem.

Name	Tipo	Description
id	string	ID do recurso
location	string	Localização do recurso
name	string	Nome do recurso
properties	CloudServiceRoleProperties	As propriedades da função de serviço de nuvem.
sku	CloudServiceRoleSku	Descreve a função de serviço de nuvem sku.
type	string	Tipo de recurso

CloudServiceRoleProperties

Object

As propriedades da função de serviço de nuvem.

Name	Tipo	Description
uniqueId	string	Especifica a ID que identifica exclusivamente uma função de serviço de nuvem.

CloudServiceRoleSku

Object

Descreve a função de serviço de nuvem sku.

Name	Tipo	Description
capacity	integer (int64)	Especifica o número de instâncias de função no serviço de nuvem.
name	string	O nome do SKU. NOTA: Se a nova SKU não for suportada no hardware em que o serviço de nuvem está atualmente, você precisará excluir e recriar o serviço de nuvem ou voltar para a sku antiga.
tier	string	Especifica a camada do serviço de nuvem. Os valores possíveis são Standard Basic

InnerError

Object

Detalhes do erro interno.

Name	Tipo	Description
errordetail	string	A mensagem de erro interna ou despejo de exceção.
exceptiontype	string	O tipo de exceção.