Certificates - Create Or Update

Služba:: App Service

Verze rozhraní API:: 2025-05-01

Popis pro Vytvoření nebo aktualizaci certifikátu.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string	Název certifikátu.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
kind		string	Druh prostředku. Pokud se jedná o prostředek aplikace, můžete se podívat na https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference, kde najdete podrobnosti o podporovaných hodnotách.
properties.canonicalName		string	CNAME certifikátu, který má být vydán prostřednictvím bezplatného certifikátu
properties.domainValidationMethod		string	Metoda ověření domény pro bezplatný certifikát
properties.hostNames		string[]	Názvy hostitelů, na které se certifikát vztahuje.
properties.keyVaultId		string (arm-id)	ID prostředku CSM služby Azure Key Vault.
properties.keyVaultSecretName		string	Název tajného kódu služby Azure Key Vault
properties.password		string	Heslo certifikátu.
properties.pfxBlob		string (byte)	Objekt blob Pfx.
properties.serverFarmId		string (arm-id)	ID prostředku přidruženého plánu služby App Service.
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	Certificate	Aktualizace resource 'Certificate' byla úspěšná
Other Status Codes	DefaultErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create Or Update Certificate

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Definice

Name	Description
Certificate	SSL certifikát pro aplikaci.
createdByType	Typ identity, která prostředek vytvořila.
DefaultErrorResponse	Odpověď na chybu služby App Service
DefaultErrorResponseError	Chybový model
DefaultErrorResponseErrorDetailsItem	Podrobné chyby.
HostingEnvironmentProfile	Specifikace služby App Service Environment, která se má použít pro tento prostředek.
KeyVaultSecretStatus	Stav tajného klíče služby Key Vault.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

Certificate

Objekt

SSL certifikát pro aplikaci.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Druh prostředku. Pokud se jedná o prostředek aplikace, můžete se podívat na https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference, kde najdete podrobnosti o podporovaných hodnotách.
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.canonicalName	string	CNAME certifikátu, který má být vydán prostřednictvím bezplatného certifikátu
properties.cerBlob	string (byte)	Nezpracované bajty souboru .cer
properties.domainValidationMethod	string	Metoda ověření domény pro bezplatný certifikát
properties.expirationDate	string (date-time)	Datum vypršení platnosti certifikátu
properties.friendlyName	string	Popisný název certifikátu.
properties.hostNames	string[]	Názvy hostitelů, na které se certifikát vztahuje.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Specifikace služby App Service Environment, která se má použít pro certifikát.
properties.issueDate	string (date-time)	Datum vydání certifikátu.
properties.issuer	string	Vystavitel certifikátu.
properties.keyVaultId	string (arm-id)	ID prostředku CSM služby Azure Key Vault.
properties.keyVaultSecretName	string	Název tajného kódu služby Azure Key Vault
properties.keyVaultSecretStatus	KeyVaultSecretStatus	Stav tajného klíče služby Key Vault.
properties.password	string	Heslo certifikátu.
properties.pfxBlob	string (byte)	Objekt blob Pfx.
properties.publicKeyHash	string	Hodnota hash veřejného klíče.
properties.selfLink	string	Vlastní odkaz.
properties.serverFarmId	string (arm-id)	ID prostředku přidruženého plánu služby App Service.
properties.siteName	string	Název aplikace.
properties.subjectName	string	Název subjektu certifikátu.
properties.thumbprint	string	Kryptografický otisk certifikátu
properties.valid	boolean	Je certifikát platný?
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objekt

Odpověď na chybu služby App Service

Name	Typ	Description
error	DefaultErrorResponseError	Chybový model

DefaultErrorResponseError

Objekt

Chybový model

Name	Typ	Description
code	string	Standardizovaný řetězec pro programovou identifikaci chyby.
details	DefaultErrorResponseErrorDetailsItem[]	Podrobné chyby.
innererror	string	Další informace k chybě ladění.
message	string	Podrobný popis chyby a informace o ladění.
target	string	Podrobný popis chyby a informace o ladění.

DefaultErrorResponseErrorDetailsItem

Objekt

Podrobné chyby.

Name	Typ	Description
code	string	Standardizovaný řetězec pro programovou identifikaci chyby.
message	string	Podrobný popis chyby a informace o ladění.
target	string	Podrobný popis chyby a informace o ladění.

HostingEnvironmentProfile

Objekt

Specifikace služby App Service Environment, která se má použít pro tento prostředek.

Name	Typ	Description
id	string	ID prostředku služby App Service Environment
name	string	Název služby App Service Environment
type	string	Typ prostředku App Service Environment.

KeyVaultSecretStatus

Výčet

Stav tajného klíče služby Key Vault.

Hodnota	Description
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Certificates - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Create Or Update Certificate

Ukázkový požadavek

Ukázková odpověď

Definice

Certificate

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

HostingEnvironmentProfile

KeyVaultSecretStatus

systemData