Set Certificate Issuer - Set Certificate Issuer

Szolgáltatás:

Key Vault

API-verzió:

2025-07-01

Beállítja a megadott tanúsítványkibocsátót.
A SetCertificateIssuer művelet hozzáadja vagy frissíti a megadott tanúsítványkiállítót. Ehhez a művelethez a certificates/setissuers engedély szükséges.

PUT {vaultBaseUrl}/certificates/issuers/{issuer-name}?api-version=2025-07-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
issuer-name	path	True	string	A kibocsátó neve. A megadott érték globálisan másolható a szolgáltatás futtatása céljából. A megadott érték nem tartalmazhat személyazonosításra alkalmas vagy érzékeny adatokat.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
provider	True	string	A kibocsátó szolgáltató.
attributes		IssuerAttributes	A kiállító objektum attribútumai.
credentials		IssuerCredentials	A kiállítóhoz használandó hitelesítő adatok.
org_details		OrganizationDetails	A szervezet adatai a kibocsátó rendelkezésére bocsátva.

Válaszok

Name	Típus	Description
200 OK	IssuerBundle	A kérés sikeres volt.
Other Status Codes	KeyVaultError	Váratlan hibaválasz.

Biztonság

OAuth2Auth

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

Hatókörök

Name	Description
https://vault.azure.net/.default

Példák

SetCertificateIssuer

Mintakérelem

HTTP

PUT https://myvault.vault.azure.net//certificates/issuers/issuer01?api-version=2025-07-01

{
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser",
    "pwd": "password"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  }
}

Mintaválasz

Állapotkód:

200

{
  "id": "https://myvault.vault.azure.net/certificates/issuers/issuer01",
  "provider": "Test",
  "credentials": {
    "account_id": "keyvaultuser"
  },
  "org_details": {
    "admin_details": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "email": "admin@microsoft.com",
        "phone": "4255555555"
      }
    ]
  },
  "attributes": {
    "enabled": true,
    "created": 1482188806,
    "updated": 1482189526
  }
}

Definíciók

Name	Description
AdministratorDetails	A tanúsítvány kibocsátójának szervezeti rendszergazdájának adatai.
CertificateIssuerSetParameters	A tanúsítvány kibocsátója paramétereket állított be.
Error
IssuerAttributes	A Key Vault szolgáltatás által kezelt kiállító attribútumai.
IssuerBundle	A Key Vault tanúsítvány kiállítója.
IssuerCredentials	A tanúsítvány kibocsátójához használandó hitelesítő adatok.
KeyVaultError	A kulcstartó hibakivétele.
OrganizationDetails	A tanúsítvány kibocsátójának szervezetének részletei.

AdministratorDetails

Objektum

A tanúsítvány kibocsátójának szervezeti rendszergazdájának adatai.

Name	Típus	Description
email	string	Email cím.
first_name	string	Keresztnév.
last_name	string	Vezetéknév.
phone	string	Telefonszám.

CertificateIssuerSetParameters

Objektum

A tanúsítvány kibocsátója paramétereket állított be.

Name	Típus	Description
attributes	IssuerAttributes	A kiállító objektum attribútumai.
credentials	IssuerCredentials	A kiállítóhoz használandó hitelesítő adatok.
org_details	OrganizationDetails	A szervezet adatai a kibocsátó rendelkezésére bocsátva.
provider	string	A kibocsátó szolgáltató.

Error

Objektum

Name	Típus	Description
code	string	A hibakód.
innererror	Error	A kulcstartó-kiszolgáló hibája.
message	string	A hibaüzenet.

IssuerAttributes

Objektum

A Key Vault szolgáltatás által kezelt kiállító attribútumai.

Name	Típus	Description
created	integer (unixtime)	Létrehozás ideje UTC-ben.
enabled	boolean	Meghatározza, hogy a kiállító engedélyezve van-e.
updated	integer (unixtime)	Utolsó frissítés időpontja UTC-ben.

IssuerBundle

Objektum

A Key Vault tanúsítvány kiállítója.

Name	Típus	Description
attributes	IssuerAttributes	A kiállító objektum attribútumai.
credentials	IssuerCredentials	A kiállítóhoz használandó hitelesítő adatok.
id	string	A kiállító objektum azonosítója.
org_details	OrganizationDetails	A szervezet adatai a kibocsátó rendelkezésére bocsátva.
provider	string	A kibocsátó szolgáltató.

IssuerCredentials

Objektum

A tanúsítvány kibocsátójához használandó hitelesítő adatok.

Name	Típus	Description
account_id	string	A felhasználónév/fióknév/fiókazonosító.
pwd	string	A jelszó/titkos/fiókkulcs.

KeyVaultError

Objektum

A kulcstartó hibakivétele.

Name	Típus	Description
error	Error	A kulcstartó-kiszolgáló hibája.

OrganizationDetails

Objektum

A tanúsítvány kibocsátójának szervezetének részletei.

Name	Típus	Description
admin_details	AdministratorDetails[]	A szervezeti rendszergazda adatai.
id	string	A szervezet azonosítója.