Certificates - Create Or Update

Szolgáltatás:: App Service

API-verzió:: 2025-05-01

A Tanúsítvány létrehozása vagy frissítése leírása.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
name	path	True	string	A tanúsítvány neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Az a földrajzi hely, ahol az erőforrás él
kind		string	Erőforrás típusa. Ha az erőforrás egy alkalmazás, a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference a természetben támogatott értékek részleteiért tekintse meg.
properties.canonicalName		string	Az ingyenes tanúsítványon keresztül kibocsátandó tanúsítvány CNAME
properties.domainValidationMethod		string	Az ingyenes tanúsítvány tartományérvényesítési módszere
properties.hostNames		string[]	A tanúsítványt tartalmazó gazdagépnevek.
properties.keyVaultId		string (arm-id)	Azure Key Vault Csm-erőforrás-azonosító.
properties.keyVaultSecretName		string	Az Azure Key Vault titkos kódneve.
properties.password		string	Tanúsítványjelszó.
properties.pfxBlob		string (byte)	Pfx-blob.
properties.serverFarmId		string (arm-id)	A társított App Service erőforrás-azonosítója.
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	Certificate	Az erőforrás 'Tanúsítvány' frissítési művelete sikeres
Other Status Codes	DefaultErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Create Or Update Certificate

Mintakérelem

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

Mintaválasz

Állapotkó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"
  }
}

Definíciók

Name	Description
Certificate	SSL-tanúsítvány egy alkalmazáshoz.
createdByType	Az erőforrást létrehozó identitás típusa.
DefaultErrorResponse	App Service-hibaválasz.
DefaultErrorResponseError	Hibamodell.
DefaultErrorResponseErrorDetailsItem	Részletes hibák.
HostingEnvironmentProfile	Az erőforráshoz használandó App Service Environment specifikációja.
KeyVaultSecretStatus	A Key Vault titkos kulcsának állapota.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Certificate

Tárgy

SSL-tanúsítvány egy alkalmazáshoz.

Name	Típus	Description
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Erőforrás típusa. Ha az erőforrás egy alkalmazás, a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference a természetben támogatott értékek részleteiért tekintse meg.
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.canonicalName	string	Az ingyenes tanúsítványon keresztül kibocsátandó tanúsítvány CNAME
properties.cerBlob	string (byte)	Nyers bájt .cer fájlból
properties.domainValidationMethod	string	Az ingyenes tanúsítvány tartományérvényesítési módszere
properties.expirationDate	string (date-time)	Tanúsítvány lejárati dátuma.
properties.friendlyName	string	A tanúsítvány rövid neve.
properties.hostNames	string[]	A tanúsítványt tartalmazó gazdagépnevek.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	A tanúsítványhoz használandó App Service Environment specifikációja.
properties.issueDate	string (date-time)	Tanúsítvány kiállításának dátuma.
properties.issuer	string	Tanúsítványkibocsátó.
properties.keyVaultId	string (arm-id)	Azure Key Vault Csm-erőforrás-azonosító.
properties.keyVaultSecretName	string	Az Azure Key Vault titkos kódneve.
properties.keyVaultSecretStatus	KeyVaultSecretStatus	A Key Vault titkos kulcsának állapota.
properties.password	string	Tanúsítványjelszó.
properties.pfxBlob	string (byte)	Pfx-blob.
properties.publicKeyHash	string	Nyilvános kulcs kivonata.
properties.selfLink	string	Önkapcsolat.
properties.serverFarmId	string (arm-id)	A társított App Service erőforrás-azonosítója.
properties.siteName	string	Alkalmazás neve.
properties.subjectName	string	A tanúsítvány tulajdonosának neve.
properties.thumbprint	string	Tanúsítvány ujjlenyomata.
properties.valid	boolean	Érvényes a tanúsítvány?
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Tárgy

App Service-hibaválasz.

Name	Típus	Description
error	DefaultErrorResponseError	Hibamodell.

DefaultErrorResponseError

Tárgy

Hibamodell.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
details	DefaultErrorResponseErrorDetailsItem[]	Részletes hibák.
innererror	string	További információ a hiba hibakereséséről.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

DefaultErrorResponseErrorDetailsItem

Tárgy

Részletes hibák.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

HostingEnvironmentProfile

Tárgy

Az erőforráshoz használandó App Service Environment specifikációja.

Name	Típus	Description
id	string	Az App Service-környezet erőforrás-azonosítója.
name	string	Az App Service-környezet neve.
type	string	A App Service Environment erőforrástípusa.

KeyVaultSecretStatus

Felsorolás

A Key Vault titkos kulcsának állapota.

Érték	Description
Initialized
WaitingOnCertificateOrder
Succeeded
CertificateOrderFailed
OperationNotPermittedOnKeyVault
AzureServiceUnauthorizedToAccessKeyVault
KeyVaultDoesNotExist
KeyVaultSecretDoesNotExist
UnknownError
ExternalPrivateKey
Unknown

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

Megosztás a következőn keresztül:

Certificates - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Create Or Update Certificate

Mintakérelem

Mintaválasz

Definíciók

Certificate

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

HostingEnvironmentProfile

KeyVaultSecretStatus

systemData