Batch Account - Get
Obtém informações sobre a conta do Lote especificada.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-02-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta do Lote. Regex pattern: |
resource
|
path | True |
string |
O nome do grupo de recursos que contém a conta do Lote. |
subscription
|
path | True |
string |
A ID de assinatura do Azure. Esta é uma cadeia de caracteres formatada por GUID (por exemplo, 000000000-0000-0000-0000-0000000000000) |
api-version
|
query | True |
string |
A versão da API a ser usada com a solicitação HTTP. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Batch |
A operação foi bem-sucedida. A resposta contém a entidade de conta do Lote. |
Other Status Codes |
Cloud |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Microsoft Entra fluxo de código de autenticação OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
Batch |
Private |
BatchAccountGet
Sample Request
Sample Response
{
"name": "sampleacct",
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"provisioningState": "Succeeded",
"poolAllocationMode": "BatchService",
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolQuota": 20,
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
"lastKeySync": "2016-03-10T23:48:38.9878479Z"
},
"publicNetworkAccess": "Enabled"
},
"identity": {
"type": "None"
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
PrivateBatchAccountGet
Sample Request
Sample Response
{
"name": "sampleacct",
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"provisioningState": "Succeeded",
"poolAllocationMode": "BatchService",
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolQuota": 20,
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
"lastKeySync": "2016-03-10T23:48:38.9878479Z"
},
"publicNetworkAccess": "Disabled",
"privateEndpointConnections": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/privateEndpointConnections/testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"name": "testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"type": "Microsoft.Batch/batchAccounts/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Network/privateEndpoints/testprivateEndpoint"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Approved by xyz.abc@company.com"
}
}
}
]
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
Definições
Nome | Description |
---|---|
Authentication |
O modo de autenticação da conta do Lote. |
Auto |
O modo de autenticação que o serviço do Lote usará para gerenciar a conta de armazenamento automático. |
Auto |
Contém informações sobre a conta de armazenamento automático associada a uma conta do Lote. |
Batch |
Contém informações sobre uma conta Lote do Azure. |
Batch |
A identidade da conta do Lote, se configurada. Isso é usado quando o usuário especifica 'Microsoft.KeyVault' como sua configuração de criptografia de conta do Lote ou quando |
Cloud |
Uma resposta de erro do serviço do Lote. |
Cloud |
Uma resposta de erro do serviço do Lote. |
Compute |
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará. |
Encryption |
Configura como os dados do cliente são criptografados na conta do Lote. Por padrão, as contas são criptografadas usando uma chave gerenciada da Microsoft. Para controle adicional, uma chave gerenciada pelo cliente pode ser usada. |
Endpoint |
A ação padrão quando não há nenhum IPRule correspondente. |
Endpoint |
Perfil de acesso à rede para o ponto de extremidade do Lote. |
IPRule |
Regra para filtrar o endereço IP do cliente. |
IPRule |
Ação quando o endereço IP do cliente é correspondido. |
Key |
Tipo da origem da chave. |
Key |
Configuração do KeyVault ao usar uma KeySource de criptografia do Microsoft.KeyVault. |
Key |
Identifica o cofre de chaves do Azure associado a uma conta do Lote. |
Network |
Perfil de rede para a conta do Lote, que contém as configurações de regra de rede para cada ponto de extremidade. |
Pool |
O modo de alocação para criar pools na conta do Lote. |
Private |
O ponto de extremidade privado da conexão de ponto de extremidade privado. |
Private |
Contém informações sobre um recurso de link privado. |
Private |
O estado de provisionamento da conexão de ponto de extremidade privado. |
Private |
O estado de conexão do serviço de link privado da conexão de ponto de extremidade privado |
Private |
O status da conexão de ponto de extremidade privado do Lote |
Provisioning |
O estado provisionado do recurso |
Public |
O tipo de acesso à rede para operar nos recursos na conta do Lote. |
Resource |
O tipo de identidade usado para a conta do Lote. |
User |
A lista de identidades de usuário associadas. |
Virtual |
Uma Família de VMs e sua cota principal associada para a conta do Lote. |
AuthenticationMode
O modo de autenticação da conta do Lote.
Nome | Tipo | Description |
---|---|---|
AAD |
string |
O modo de autenticação usando Microsoft Entra ID. |
SharedKey |
string |
O modo de autenticação usando chaves compartilhadas. |
TaskAuthenticationToken |
string |
O modo de autenticação usando tokens de autenticação de tarefa. |
AutoStorageAuthenticationMode
O modo de autenticação que o serviço do Lote usará para gerenciar a conta de armazenamento automático.
Nome | Tipo | Description |
---|---|---|
BatchAccountManagedIdentity |
string |
O serviço lote autenticará solicitações para armazenamento automático usando a identidade gerenciada atribuída à conta do Lote. |
StorageKeys |
string |
O serviço lote autenticará solicitações para armazenamento automático usando chaves de conta de armazenamento. |
AutoStorageProperties
Contém informações sobre a conta de armazenamento automático associada a uma conta do Lote.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
authenticationMode |
Auto |
StorageKeys |
O modo de autenticação que o serviço do Lote usará para gerenciar a conta de armazenamento automático. |
lastKeySync |
string |
A hora UTC em que as chaves de armazenamento foram sincronizadas pela última vez com a conta do Lote. |
|
nodeIdentityReference |
Compute |
A referência à identidade atribuída pelo usuário que os nós de computação usarão para acessar o armazenamento automático. |
|
storageAccountId |
string |
A ID do recurso da conta de armazenamento a ser usada para a conta de armazenamento automático. |
BatchAccount
Contém informações sobre uma conta Lote do Azure.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
id |
string |
A ID do recurso. |
|
identity |
Batch |
A identidade da conta do Lote. |
|
location |
string |
A localização do recurso. |
|
name |
string |
O nome do recurso. |
|
properties.accountEndpoint |
string |
O ponto de extremidade da conta usado para interagir com o serviço do Lote. |
|
properties.activeJobAndJobScheduleQuota |
integer |
O trabalho ativo e a cota de agendamento de trabalho para a conta do Lote. |
|
properties.allowedAuthenticationModes |
Authentication |
Lista de modos de autenticação permitidos para a conta do Lote que pode ser usada para autenticar com o plano de dados. Isso não afeta a autenticação com o painel de controle. |
|
properties.autoStorage |
Auto |
As propriedades e status de qualquer conta de armazenamento automático associada à conta do Lote. |
|
properties.dedicatedCoreQuota |
integer |
A cota de núcleo dedicada para a conta do Lote. |
|
properties.dedicatedCoreQuotaPerVMFamily |
Virtual |
Uma lista da cota de núcleo dedicada por família de Máquinas Virtuais para a conta do Lote. Para contas com PoolAllocationMode definido como UserSubscription, a cota é gerenciada na assinatura para que esse valor não seja retornado. |
|
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Um valor que indica se as cotas principais por família de Máquinas Virtuais são impostas para essa conta |
|
properties.encryption |
Encryption |
A configuração de criptografia para a conta do Lote. |
|
properties.keyVaultReference |
Key |
Uma referência ao cofre de chaves do Azure associado à conta do Lote. |
|
properties.lowPriorityCoreQuota |
integer |
A cota de núcleo spot/de baixa prioridade para a conta do Lote. |
|
properties.networkProfile |
Network |
Perfil de rede para a conta do Lote, que contém as configurações de regra de rede para cada ponto de extremidade. |
|
properties.nodeManagementEndpoint |
string |
O ponto de extremidade usado pelo nó de computação para se conectar ao serviço de gerenciamento de nós do Lote. |
|
properties.poolAllocationMode |
Pool |
O modo de alocação a ser usado para criar pools na conta do Lote. |
|
properties.poolQuota |
integer |
A cota de pool para a conta do Lote. |
|
properties.privateEndpointConnections |
Private |
Lista de conexões de ponto de extremidade privado associadas à conta do Lote |
|
properties.provisioningState |
Provisioning |
O estado provisionado do recurso |
|
properties.publicNetworkAccess |
Public |
Enabled |
O tipo de interface de rede para acessar Lote do Azure serviço e operações de conta do Lote. |
tags |
object |
As marcas do recurso. |
|
type |
string |
Tipo do recurso. |
BatchAccountIdentity
A identidade da conta do Lote, se configurada. Isso é usado quando o usuário especifica 'Microsoft.KeyVault' como sua configuração de criptografia de conta do Lote ou quando ManagedIdentity
é selecionado como o modo de autenticação de armazenamento automático.
Nome | Tipo | Description |
---|---|---|
principalId |
string |
A ID principal da conta do Lote. Essa propriedade só será fornecida para uma identidade atribuída pelo sistema. |
tenantId |
string |
A ID do locatário associada à conta do Lote. Essa propriedade só será fornecida para uma identidade atribuída pelo sistema. |
type |
Resource |
O tipo de identidade usado para a conta do Lote. |
userAssignedIdentities |
object |
A lista de identidades de usuário associadas à conta do Lote. |
CloudError
Uma resposta de erro do serviço do Lote.
Nome | Tipo | Description |
---|---|---|
error |
Cloud |
O corpo da resposta de erro. |
CloudErrorBody
Uma resposta de erro do serviço do Lote.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
details |
Cloud |
Uma lista de detalhes adicionais sobre o erro. |
message |
string |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
target |
string |
O destino do erro específico. Por exemplo, o nome da propriedade em erro. |
ComputeNodeIdentityReference
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará.
Nome | Tipo | Description |
---|---|---|
resourceId |
string |
A ID de recurso do ARM da identidade atribuída pelo usuário. |
EncryptionProperties
Configura como os dados do cliente são criptografados na conta do Lote. Por padrão, as contas são criptografadas usando uma chave gerenciada da Microsoft. Para controle adicional, uma chave gerenciada pelo cliente pode ser usada.
Nome | Tipo | Description |
---|---|---|
keySource |
Key |
Tipo da origem da chave. |
keyVaultProperties |
Key |
Detalhes adicionais ao usar Microsoft.KeyVault |
EndpointAccessDefaultAction
A ação padrão quando não há nenhum IPRule correspondente.
Nome | Tipo | Description |
---|---|---|
Allow |
string |
Permitir o acesso do cliente. |
Deny |
string |
Negar acesso ao cliente. |
EndpointAccessProfile
Perfil de acesso à rede para o ponto de extremidade do Lote.
Nome | Tipo | Description |
---|---|---|
defaultAction |
Endpoint |
A ação padrão quando não há nenhum IPRule correspondente. |
ipRules |
IPRule[] |
Matriz de intervalos de IP para filtrar o endereço IP do cliente. |
IPRule
Regra para filtrar o endereço IP do cliente.
Nome | Tipo | Description |
---|---|---|
action |
IPRule |
Ação quando o endereço IP do cliente é correspondido. |
value |
string |
O endereço IP ou intervalo de endereços IP a ser filtrado |
IPRuleAction
Ação quando o endereço IP do cliente é correspondido.
Nome | Tipo | Description |
---|---|---|
Allow |
string |
Permitir acesso para o endereço IP do cliente correspondente. |
KeySource
Tipo da origem da chave.
Nome | Tipo | Description |
---|---|---|
Microsoft.Batch |
string |
O Lote cria e gerencia as chaves de criptografia usadas para proteger os dados da conta. |
Microsoft.KeyVault |
string |
As chaves de criptografia usadas para proteger os dados da conta são armazenadas em um cofre de chaves externo. Se isso for definido, a identidade da Conta do Lote deverá ser definida |
KeyVaultProperties
Configuração do KeyVault ao usar uma KeySource de criptografia do Microsoft.KeyVault.
Nome | Tipo | Description |
---|---|---|
keyIdentifier |
string |
Caminho completo para o segredo com ou sem versão. Exemplo https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. ou https://mykeyvault.vault.azure.net/keys/testkey. Para ser utilizável, os seguintes pré-requisitos devem ser atendidos: A Conta do Lote tem uma identidade atribuída pelo sistema A identidade da conta recebeu as permissões Key/Get, Key/Unwrap e Key/Wrap. O KeyVault tem a proteção contra exclusão reversível e limpeza habilitada |
KeyVaultReference
Identifica o cofre de chaves do Azure associado a uma conta do Lote.
Nome | Tipo | Description |
---|---|---|
id |
string |
A ID de recurso do cofre de chaves do Azure associada à conta do Lote. |
url |
string |
A URL do cofre de chaves do Azure associada à conta do Lote. |
NetworkProfile
Perfil de rede para a conta do Lote, que contém as configurações de regra de rede para cada ponto de extremidade.
Nome | Tipo | Description |
---|---|---|
accountAccess |
Endpoint |
Perfil de acesso à rede para o ponto de extremidade batchAccount (API do plano de dados da conta do Lote). |
nodeManagementAccess |
Endpoint |
Perfil de acesso à rede para o ponto de extremidade nodeManagement (serviço do Lote que gerencia nós de computação para pools do Lote). |
PoolAllocationMode
O modo de alocação para criar pools na conta do Lote.
Nome | Tipo | Description |
---|---|---|
BatchService |
string |
Os pools serão alocados em assinaturas pertencentes ao serviço do Lote. |
UserSubscription |
string |
Os pools serão alocados em uma assinatura de propriedade do usuário. |
PrivateEndpoint
O ponto de extremidade privado da conexão de ponto de extremidade privado.
Nome | Tipo | Description |
---|---|---|
id |
string |
O identificador de recurso arm do ponto de extremidade privado. Este é do formulário /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Contém informações sobre um recurso de link privado.
Nome | Tipo | Description |
---|---|---|
etag |
string |
A ETag do recurso, usada para instruções de simultaneidade. |
id |
string |
A ID do recurso. |
name |
string |
O nome do recurso. |
properties.groupIds |
string[] |
A ID do grupo da conexão de ponto de extremidade privado. |
properties.privateEndpoint |
Private |
O identificador de recurso arm do ponto de extremidade privado. |
properties.privateLinkServiceConnectionState |
Private |
O estado de conexão do serviço de link privado da conexão de ponto de extremidade privado. |
properties.provisioningState |
Private |
O estado de provisionamento da conexão de ponto de extremidade privado. |
type |
string |
Tipo do recurso. |
PrivateEndpointConnectionProvisioningState
O estado de provisionamento da conexão de ponto de extremidade privado.
Nome | Tipo | Description |
---|---|---|
Cancelled |
string |
O usuário cancelou a criação da conexão. |
Creating |
string |
A conexão está sendo criada. |
Deleting |
string |
A conexão está excluindo. |
Failed |
string |
O usuário solicitou que a conexão fosse atualizada e ela falhou. Você pode repetir a operação de atualização. |
Succeeded |
string |
A status de conexão é final e estará pronta para uso se Status for Aprovado. |
Updating |
string |
O usuário solicitou que a conexão status ser atualizada, mas a operação de atualização ainda não foi concluída. Você não pode referenciar a conexão ao conectar a conta do Lote. |
PrivateLinkServiceConnectionState
O estado de conexão do serviço de link privado da conexão de ponto de extremidade privado
Nome | Tipo | Description |
---|---|---|
actionsRequired |
string |
Ação necessária no estado de conexão privada |
description |
string |
Descrição do estado de conexão privada |
status |
Private |
O status para a conexão de ponto de extremidade privado da conta do Lote |
PrivateLinkServiceConnectionStatus
O status da conexão de ponto de extremidade privado do Lote
Nome | Tipo | Description |
---|---|---|
Approved |
string |
A conexão de ponto de extremidade privado é aprovada e pode ser usada para acessar a conta do Lote |
Disconnected |
string |
A conexão de ponto de extremidade privado está desconectada e não pode ser usada para acessar a conta do Lote |
Pending |
string |
A conexão de ponto de extremidade privado está pendente e não pode ser usada para acessar a conta do Lote |
Rejected |
string |
A conexão de ponto de extremidade privado é rejeitada e não pode ser usada para acessar a conta do Lote |
ProvisioningState
O estado provisionado do recurso
Nome | Tipo | Description |
---|---|---|
Cancelled |
string |
A última operação da conta foi cancelada. |
Creating |
string |
A conta está sendo criada. |
Deleting |
string |
A conta está sendo excluída. |
Failed |
string |
Falha na última operação da conta. |
Invalid |
string |
A conta está em um estado inválido. |
Succeeded |
string |
A conta foi criada e está pronta para uso. |
PublicNetworkAccessType
O tipo de acesso à rede para operar nos recursos na conta do Lote.
Nome | Tipo | Description |
---|---|---|
Disabled |
string |
Desabilita a conectividade pública e permite que a conectividade privada Lote do Azure Serviço por meio de um recurso de ponto de extremidade privado. |
Enabled |
string |
Permite que a conectividade Lote do Azure por meio do DNS público. |
ResourceIdentityType
O tipo de identidade usado para a conta do Lote.
Nome | Tipo | Description |
---|---|---|
None |
string |
A conta do Lote não tem nenhuma identidade associada a ela. A configuração |
SystemAssigned |
string |
A conta do Lote tem uma identidade atribuída pelo sistema com ela. |
UserAssigned |
string |
A conta do Lote tem identidades atribuídas pelo usuário com ela. |
UserAssignedIdentities
A lista de identidades de usuário associadas.
Nome | Tipo | Description |
---|---|---|
clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
principalId |
string |
A ID principal da identidade atribuída pelo usuário. |
VirtualMachineFamilyCoreQuota
Uma Família de VMs e sua cota principal associada para a conta do Lote.
Nome | Tipo | Description |
---|---|---|
coreQuota |
integer |
A cota principal para a família de VMs da conta do Lote. |
name |
string |
O nome da família da Máquina Virtual. |