Application Package - Activate

Attiva il pacchetto dell'applicazione specificato. Questa operazione deve essere eseguita dopo la creazione e il caricamento del ApplicationPackage. Questa operazione deve essere eseguita prima che un ApplicationPackage possa essere usato in pool o attività.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
path True

string

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

Un nome per l'account Batch che deve essere unico all'interno della regione. I nomi dei conti dei lotti devono avere una lunghezza compresa tra 3 e 24 caratteri e devono utilizzare solo numeri e lettere minuscole. Questo nome viene utilizzato come parte del nome DNS utilizzato per accedere al servizio Batch nella regione in cui l'account è stato creato. Ad esempio: http://accountname.region.batch.azure.com/.

applicationName
path True

string

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

Nome dell'applicazione. Deve essere univoco all'interno dell'account.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

subscriptionId
path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

versionName
path True

string

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

Versione dell'applicazione.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
format True

string

Formato del file binario del pacchetto dell'applicazione.

Risposte

Nome Tipo Descrizione
200 OK

ApplicationPackage

L'operazione di Azure è stata completata correttamente.

Other Status Codes

CloudError

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ApplicationPackageActivate

Esempio di richiesta

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"
}

Risposta di esempio

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"
  }
}

Definizioni

Nome Descrizione
ActivateApplicationPackageParameters

Parametri per un'attivazione di un pacchetto dell'applicazione.

ApplicationPackage

Pacchetto dell'applicazione che rappresenta una versione specifica di un'applicazione.

CloudError

Risposta di errore dal servizio Batch.

CloudErrorBody

Risposta di errore dal servizio Batch.

createdByType

Tipo di identità che ha creato la risorsa.

PackageState

Stato corrente del pacchetto dell'applicazione.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

ActivateApplicationPackageParameters

Parametri per un'attivazione di un pacchetto dell'applicazione.

Nome Tipo Descrizione
format

string

Formato del file binario del pacchetto dell'applicazione.

ApplicationPackage

Pacchetto dell'applicazione che rappresenta una versione specifica di un'applicazione.

Nome Tipo Descrizione
etag

string

ETag della risorsa, usata per le istruzioni di concorrenza.

id

string (arm-id)

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties.format

string

Formato del pacchetto dell'applicazione, se il pacchetto è attivo.

properties.lastActivationTime

string (date-time)

Ora dell'ultima attivazione del pacchetto, se il pacchetto è attivo.

properties.state

PackageState

Stato corrente del pacchetto dell'applicazione.

properties.storageUrl

string

URL del pacchetto dell'applicazione in Archiviazione di Azure.

properties.storageUrlExpiry

string (date-time)

Ora UTC in cui scadrà l'URL di Archiviazione di Azure.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.

tags

object

Tag della risorsa.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

CloudError

Risposta di errore dal servizio Batch.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo della risposta di errore.

CloudErrorBody

Risposta di errore dal servizio Batch.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

createdByType

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

PackageState

Stato corrente del pacchetto dell'applicazione.

Valore Descrizione
Pending

Il pacchetto dell'applicazione è stato creato ma non è ancora stato attivato.

Active

Il pacchetto dell'applicazione è pronto per l'uso.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string (date-time)

Il timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.