Certificates - Create Or Update

Servizio:: App Service

Versione API:: 2025-05-01

Descrizione per Creare o aggiornare un certificato.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/certificates/{name}?api-version=2025-05-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
name	path	True	string	Nome del certificato.
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.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
kind		string	Tipo di risorsa. Se la risorsa è un'app, è possibile fare riferimento a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference per informazioni dettagliate sui valori supportati per il tipo.
properties.canonicalName		string	CNAME del certificato da rilasciare tramite certificato gratuito
properties.domainValidationMethod		string	Metodo di convalida del dominio per il certificato gratuito
properties.hostNames		string[]	Nomi host a cui si applica il certificato.
properties.keyVaultId		string (arm-id)	ID risorsa Csm di Azure Key Vault.
properties.keyVaultSecretName		string	Nome del segreto di Azure Key Vault.
properties.password		string	Password del certificato.
properties.pfxBlob		string (byte)	BLOB Pfx.
properties.serverFarmId		string (arm-id)	ID risorsa del piano di servizio app associato.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	Certificate	Operazione di aggiornamento 'Certificate' della risorsa riuscita
Other Status Codes	DefaultErrorResponse	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

Create Or Update Certificate

Esempio di richiesta

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282?api-version=2025-05-01

{
  "location": "East US",
  "properties": {
    "hostNames": [
      "ServerCert"
    ],
    "password": "<password>"
  }
}


import com.azure.resourcemanager.appservice.fluent.models.CertificateInner;
import java.util.Arrays;

/**
 * Samples for Certificates CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/CreateOrUpdateCertificate.json
     */
    /**
     * Sample code: Create Or Update Certificate.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void createOrUpdateCertificate(com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getCertificates().createOrUpdateWithResponse(
            "testrg123", "testc6282", new CertificateInner().withLocation("East US")
                .withPassword("fakeTokenPlaceholder").withHostNames(Arrays.asList("ServerCert")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v6"
)

// Generated from example definition: 2025-05-01/CreateOrUpdateCertificate.json
func ExampleCertificatesClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewCertificatesClient().CreateOrUpdate(ctx, "testrg123", "testc6282", armappservice.AppCertificate{
		Location: to.Ptr("East US"),
		Properties: &armappservice.AppCertificateProperties{
			HostNames: []*string{
				to.Ptr("ServerCert"),
			},
			Password: to.Ptr("<password>"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappservice.CertificatesClientCreateOrUpdateResponse{
	// 	AppCertificate: &armappservice.AppCertificate{
	// 		Name: to.Ptr("testc6282"),
	// 		Type: to.Ptr("Microsoft.Web/certificates"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282"),
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappservice.AppCertificateProperties{
	// 			ExpirationDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2039-12-31T23:59:59+00:00"); return t}()),
	// 			FriendlyName: to.Ptr(""),
	// 			HostNames: []*string{
	// 				to.Ptr("ServerCert"),
	// 			},
	// 			IssueDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2015-11-12T23:40:25+00:00"); return t}()),
	// 			Issuer: to.Ptr("CACert"),
	// 			SubjectName: to.Ptr("ServerCert"),
	// 			Thumbprint: to.Ptr("FE703D7411A44163B6D32B3AD9B03E175886EBFE"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "name": "testc6282",
  "type": "Microsoft.Web/certificates",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/certificates/testc6282",
  "location": "East US",
  "properties": {
    "expirationDate": "2039-12-31T23:59:59+00:00",
    "friendlyName": "",
    "hostNames": [
      "ServerCert"
    ],
    "issueDate": "2015-11-12T23:40:25+00:00",
    "issuer": "CACert",
    "subjectName": "ServerCert",
    "thumbprint": "FE703D7411A44163B6D32B3AD9B03E175886EBFE"
  }
}

Definizioni

Nome	Descrizione
Certificate	Certificato SSL per un'app.
createdByType	Tipo di identità che ha creato la risorsa.
DefaultErrorResponse	Risposta di errore del servizio app.
DefaultErrorResponseError	Modello di errore.
DefaultErrorResponseErrorDetailsItem	Errori dettagliati.
HostingEnvironmentProfile	Specifica per un ambiente del servizio app da usare per questa risorsa.
KeyVaultSecretStatus	Stato del segreto Key Vault.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

Certificate

Oggetto

Certificato SSL per un'app.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo di risorsa. Se la risorsa è un'app, è possibile fare riferimento a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference per informazioni dettagliate sui valori supportati per il tipo.
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.canonicalName	string	CNAME del certificato da rilasciare tramite certificato gratuito
properties.cerBlob	string (byte)	Byte non elaborati del file di .cer
properties.domainValidationMethod	string	Metodo di convalida del dominio per il certificato gratuito
properties.expirationDate	string (date-time)	Data di scadenza del certificato.
properties.friendlyName	string	Nome descrittivo del certificato.
properties.hostNames	string[]	Nomi host a cui si applica il certificato.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specifica per l'ambiente del servizio app da usare per il certificato.
properties.issueDate	string (date-time)	Data di emissione del certificato.
properties.issuer	string	Autorità di certificazione.
properties.keyVaultId	string (arm-id)	ID risorsa Csm di Azure Key Vault.
properties.keyVaultSecretName	string	Nome del segreto di Azure Key Vault.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Stato del segreto Key Vault.
properties.password	string	Password del certificato.
properties.pfxBlob	string (byte)	BLOB Pfx.
properties.publicKeyHash	string	Hash della chiave pubblica.
properties.selfLink	string	Collegamento automatico.
properties.serverFarmId	string (arm-id)	ID risorsa del piano di servizio app associato.
properties.siteName	string	Nome dell'app.
properties.subjectName	string	Nome soggetto del certificato.
properties.thumbprint	string	Identificazione personale del certificato.
properties.valid	boolean	Il certificato è valido?.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Oggetto

Risposta di errore del servizio app.

Nome	Tipo	Descrizione
error	DefaultErrorResponseError	Modello di errore.

DefaultErrorResponseError

Oggetto

Modello di errore.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
details	DefaultErrorResponseErrorDetailsItem[]	Errori dettagliati.
innererror	string	Ulteriori informazioni per eseguire il debug dell'errore.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

DefaultErrorResponseErrorDetailsItem

Oggetto

Errori dettagliati.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

HostingEnvironmentProfile

Oggetto

Specifica per un ambiente del servizio app da usare per questa risorsa.

Nome	Tipo	Descrizione
id	string	ID risorsa dell'ambiente del servizio app.
name	string	Nome dell'ambiente del servizio app.
type	string	Tipo di risorsa dell'ambiente del servizio app.

KeyVaultSecretStatus

Enumerazione

Stato del segreto Key Vault.

Valore	Descrizione
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Oggetto

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)	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.

Condividi tramite

Certificates - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create Or Update Certificate

Esempio di richiesta

Risposta di esempio

Definizioni

Certificate

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

HostingEnvironmentProfile

KeyVaultSecretStatus

systemData