Certificate - Add

Servizio:

Batch Service

Versione API:

2024-07-01.20.0

Aggiunge un certificato all'account specificato.
Avviso: questa operazione è deprecata e verrà rimossa dopo febbraio 2024. Usare invece 'estensione Azure KeyVault.

POST {batchUrl}/certificates?api-version=2024-07-01.20.0

Con parametri facoltativi:

POST {batchUrl}/certificates?timeout={timeout}&api-version=2024-07-01.20.0

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
batchUrl	path	True	string	URL di base per tutte le richieste del servizio Azure Batch.
api-version	query	True	string	Versione dell'API client.
timeout	query		integer int32	Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito.

Intestazione della richiesta

Media Types: "application/json; odata=minimalmetadata"

Nome	Necessario	Tipo	Descrizione
client-request-id		string uuid	Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date		string date-time-rfc1123	Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Corpo della richiesta

Media Types: "application/json; odata=minimalmetadata"

Nome	Necessario	Tipo	Descrizione
data	True	string	Contenuto con codifica Base64 del certificato. La dimensione massima è 10 KB.
thumbprint	True	string	Identificazione personale X.509 del certificato. Si tratta di una sequenza di un massimo di 40 cifre esadecimale (può includere spazi ma vengono rimossi).
thumbprintAlgorithm	True	string	Algoritmo utilizzato per derivare l'identificazione personale. Deve essere sha1.
certificateFormat		CertificateFormat	Formato dei dati del certificato.
password		string	Password per accedere alla chiave privata del certificato. Deve essere omesso se il formato certificato è cer.

Risposte

Nome	Tipo	Descrizione
201 Created		La richiesta al servizio Batch ha avuto esito positivo. Intestazioni client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Errore del servizio Batch.

Sicurezza

azure_auth

Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0

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

Ambiti

Nome	Descrizione
user_impersonation	Rappresentare l'account utente

Authorization

Tipo: apiKey
In: header

Esempio

Certificate add

Esempio di richiesta

HTTP

POST account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0



{
  "thumbprintAlgorithm": "sha1",
  "thumbprint": "0123456789abcdef0123456789abcdef01234567",
  "data": "#####...",
  "certificateFormat": "pfx",
  "password": "<ExamplePassword>"
}

Risposta di esempio

Codice di stato:

201

Definizioni

Nome	Descrizione
BatchError	Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail	Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
CertificateAddParameter	Un certificato che può essere installato nei nodi di calcolo e può essere usato per autenticare le operazioni nel computer.
CertificateFormat	Formato dei dati del certificato.
ErrorMessage	Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

BatchError

Risposta di errore ricevuta dal servizio Azure Batch.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	ErrorMessage	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values	BatchErrorDetail[]	Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
key	string	Identificatore che specifica il significato della proprietà Value.
value	string	Informazioni aggiuntive incluse nella risposta di errore.

CertificateAddParameter

Un certificato che può essere installato nei nodi di calcolo e può essere usato per autenticare le operazioni nel computer.

Nome	Tipo	Descrizione
certificateFormat	CertificateFormat	Formato dei dati del certificato.
data	string	Contenuto con codifica Base64 del certificato. La dimensione massima è 10 KB.
password	string	Password per accedere alla chiave privata del certificato. Deve essere omesso se il formato certificato è cer.
thumbprint	string	Identificazione personale X.509 del certificato. Si tratta di una sequenza di un massimo di 40 cifre esadecimale (può includere spazi ma vengono rimossi).
thumbprintAlgorithm	string	Algoritmo utilizzato per derivare l'identificazione personale. Deve essere sha1.

CertificateFormat

Formato dei dati del certificato.

Nome	Tipo	Descrizione
cer	string	Il certificato è un certificato X.509 con codifica Base64.
pfx	string	Il certificato è un certificato o una catena di certificati in formato PFX (PKCS#12).

ErrorMessage

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome	Tipo	Descrizione
lang	string	Codice linguistico del messaggio di errore
value	string	Testo del messaggio.