Application Package - Activate

Ativa o pacote de aplicativos especificado. Isso deve ser feito depois que o ApplicationPackage foi criado e carregado. Isso precisa ser feito antes que um ApplicationPackage possa ser usado em Pools ou Tarefas.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}/versions/{versionName}/activate?api-version=2025-06-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-zA-Z0-9]+$

Um nome para a conta Batch que deve ser única dentro da região. Os nomes das contas do lote devem ter entre 3 e 24 caracteres de extensão e devem usar apenas números e letras minúsculas. Esse nome é usado como parte do nome DNS usado para acessar o serviço Batch na região onde a conta é criada. Por exemplo: http://accountname.region.batch.azure.com/.

applicationName
path True

string

minLength: 1
maxLength: 64
pattern: ^[a-zA-Z0-9_-]+$

O nome do aplicativo. Isso deve ser exclusivo dentro da conta.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

versionName
path True

string

minLength: 1
maxLength: 64
pattern: ^[a-zA-Z0-9_-][a-zA-Z0-9_.-]*$

A versão do aplicativo.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
format True

string

O formato do arquivo binário do pacote de aplicativos.

Respostas

Nome Tipo Description
200 OK

ApplicationPackage

A operação do Azure foi concluída com êxito.

Other Status Codes

CloudError

Uma resposta de erro inesperada.

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

ApplicationPackageActivate

Solicitação de exemplo

POST https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/applications/app1/versions/1/activate?api-version=2025-06-01

{
  "format": "zip"
}

Resposta de exemplo

ETag: W/"0x8D64FEC83A3B436"
{
  "name": "1",
  "type": "Microsoft.Batch/batchAccounts/applications/versions",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/applications/app1/versions/1",
  "properties": {
    "format": "zip",
    "lastActivationTime": "2017-06-27T18:48:09.9330991Z",
    "state": "Active"
  }
}

Definições

Nome Description
ActivateApplicationPackageParameters

Parâmetros para ativar um pacote de aplicativos.

ApplicationPackage

Um pacote de aplicativos que representa uma versão específica de um aplicativo.

CloudError

Uma resposta de erro do serviço do Lote.

CloudErrorBody

Uma resposta de erro do serviço do Lote.

createdByType

O tipo de identidade que criou o recurso.

PackageState

O estado atual do pacote de aplicativos.

systemData

Metadados relativos à criação e última modificação do recurso.

ActivateApplicationPackageParameters

Parâmetros para ativar um pacote de aplicativos.

Nome Tipo Description
format

string

O formato do arquivo binário do pacote de aplicativos.

ApplicationPackage

Um pacote de aplicativos que representa uma versão específica de um aplicativo.

Nome Tipo Description
etag

string

A ETag do recurso, usada para instruções de simultaneidade.

id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.format

string

O formato do pacote de aplicativos, se o pacote estiver ativo.

properties.lastActivationTime

string (date-time)

A hora em que o pacote foi ativado pela última vez, se o pacote estiver ativo.

properties.state

PackageState

O estado atual do pacote de aplicativos.

properties.storageUrl

string

A URL do pacote de aplicativos no Armazenamento do Azure.

properties.storageUrlExpiry

string (date-time)

A hora UTC em que a URL de Armazenamento do Azure expirará.

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.

tags

object

As marcas do recurso.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

CloudError

Uma resposta de erro do serviço do Lote.

Nome Tipo Description
error

CloudErrorBody

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

CloudErrorBody[]

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.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

PackageState

O estado atual do pacote de aplicativos.

Valor Description
Pending

O pacote de aplicativos foi criado, mas ainda não foi ativado.

Active

O pacote de aplicativos está pronto para uso.

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

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

createdByType

O tipo de identidade que modificou o recurso pela última vez.