Share via


Attestations - List For Subscription

Abonelik için tüm kanıtlamaları alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations?api-version=2022-09-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/attestations?$top={$top}&$filter={$filter}&api-version=2022-09-01

URI Parametreleri

Name İçinde Gerekli Tür Description
subscriptionId
path True

string

Hedef aboneliğin kimliği.

api-version
query True

string

Bu işlem için kullanılacak API sürümü.

$filter
query

string

OData filtre ifadesi.

$top
query

integer

int32

Döndürülecek kayıt sayısı üst sınırı.

Yanıtlar

Name Tür Description
200 OK

AttestationListResult

Alınan kanıtlamalar.

Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

List attestations at subscription scope
List attestations at subscription scope with query parameters

List attestations at subscription scope

Sample Request

GET https://management.azure.com/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/Microsoft.PolicyInsights/attestations?api-version=2022-09-01

Sample Response

{
  "value": [
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
        "policyDefinitionReferenceId": "0b158b46-ff42-4799-8e39-08a5c23b4551",
        "complianceState": "Compliant",
        "lastComplianceStateChangeAt": "2020-06-15T18:52:27Z",
        "expiresOn": "2021-06-15T00:00:00Z",
        "owner": "55a32e28-3aa5-4eea-9b5a-4cd85153b966",
        "comments": "This subscription has passed a security audit.",
        "evidence": [
          {
            "description": "The results of the security audit.",
            "sourceUri": "https://gist.github.com/contoso/9573e238762c60166c090ae16b814011"
          }
        ],
        "assessmentDate": "2021-06-10T00:00:00Z",
        "metadata": {
          "departmentId": "NYC-MARKETING-1"
        },
        "provisioningState": "Succeeded"
      },
      "systemData": {
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "createdByType": "User",
        "createdAt": "2020-06-15T18:52:27Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-06-15T18:52:27Z"
      },
      "id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.policyinsights/attestations/790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "name": "790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "type": "Microsoft.PolicyInsights/attestations"
    },
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/090a47f8-13e9-441e-ad90-dc666cc5d487",
        "complianceState": "Compliant",
        "lastComplianceStateChangeAt": "2020-06-15T18:52:27Z",
        "provisioningState": "Succeeded"
      },
      "systemData": {
        "createdBy": "34709f31-f267-4eee-8479-0da11925f2f2",
        "createdByType": "User",
        "createdAt": "2020-06-15T18:52:27Z",
        "lastModifiedBy": "34709f31-f267-4eee-8479-0da11925f2f2",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-06-15T18:52:27Z"
      },
      "id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/resourcegroups/myrg/providers/microsoft.policyinsights/attestations/689bfc0c-a012-49fc-af40-3ebea35ff3ed",
      "name": "689bfc0c-a012-49fc-af40-3ebea35ff3ed",
      "type": "Microsoft.PolicyInsights/attestations"
    }
  ]
}

List attestations at subscription scope with query parameters

Sample Request

GET https://management.azure.com/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/Microsoft.PolicyInsights/attestations?$top=1&$filter=PolicyAssignmentId eq '/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5' AND PolicyDefinitionReferenceId eq '0b158b46-ff42-4799-8e39-08a5c23b4551'&api-version=2022-09-01

Sample Response

{
  "value": [
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5",
        "policyDefinitionReferenceId": "0b158b46-ff42-4799-8e39-08a5c23b4551",
        "complianceState": "Compliant",
        "lastComplianceStateChangeAt": "2020-06-15T18:52:27Z",
        "expiresOn": "2021-06-15T00:00:00Z",
        "owner": "55a32e28-3aa5-4eea-9b5a-4cd85153b966",
        "comments": "This subscription has passed a security audit.",
        "evidence": [
          {
            "description": "The results of the security audit.",
            "sourceUri": "https://gist.github.com/contoso/9573e238762c60166c090ae16b814011"
          }
        ],
        "assessmentDate": "2021-06-10T00:00:00Z",
        "metadata": {
          "departmentId": "NYC-MARKETING-1"
        },
        "provisioningState": "Succeeded"
      },
      "systemData": {
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "createdByType": "User",
        "createdAt": "2020-06-15T18:52:27Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef6",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-06-15T18:52:27Z"
      },
      "id": "/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.policyinsights/attestations/790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "name": "790996e6-9871-4b1f-9cd9-ec42cd6ced1e",
      "type": "Microsoft.PolicyInsights/attestations"
    }
  ]
}

Tanımlar

Name Description
Attestation

Kanıtlama kaynağı.

AttestationEvidence

Kanıtlamada ayarlanan uyumluluk durumunu destekleyen bir kanıt parçası.

AttestationListResult

Kanıtlamaların listesi.

ComplianceState

Kaynakta ayarlanması gereken uyumluluk durumu.

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorDefinition

Hata tanımı.

ErrorResponse

Hata yanıtı.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

TypedErrorInfo

Senaryoya özgü hata ayrıntıları.

Attestation

Kanıtlama kaynağı.

Name Tür Description
id

string

Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Kaynağın adı

properties.assessmentDate

string

Kanıtın değerlendirildiği zaman

properties.comments

string

Bu kanıtlamanın neden oluşturulduğunu açıklayan açıklamalar.

properties.complianceState

ComplianceState

Kaynakta ayarlanması gereken uyumluluk durumu.

properties.evidence

AttestationEvidence[]

Bu kanıtlamada ayarlanan uyumluluk durumunu destekleyen kanıtlar.

properties.expiresOn

string

Uyumluluk durumunun süresinin dolması gereken süre.

properties.lastComplianceStateChangeAt

string

Bu kanıtlamada uyumluluk durumunun son değiştirildiği saat.

properties.metadata

object

Bu kanıtlama için ek meta veriler

properties.owner

string

Kaynağın durumunu ayarlamakla sorumlu kişi. Bu değer genellikle bir Azure Active Directory nesne kimliğidir.

properties.policyAssignmentId

string

Kanıtlamanın durumunu ayarlayan ilke atamasının kaynak kimliği.

properties.policyDefinitionReferenceId

string

Kanıtlamanın durumunu ayarlandığı ilke kümesi tanımından ilke tanımı başvuru kimliği. İlke ataması bir ilke kümesi tanımı atarsa, kanıtlama bu özellik ile küme tanımı içinde bir tanım seçebilir veya bunu atlayabilir ve küme tanımının tamamının durumunu ayarlayabilir.

properties.provisioningState

string

Kanıtlamanın durumu.

systemData

systemData

Azure Resource Manager createdBy ve modifiedBy bilgilerini içeren meta veriler.

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

AttestationEvidence

Kanıtlamada ayarlanan uyumluluk durumunu destekleyen bir kanıt parçası.

Name Tür Description
description

string

Bu kanıtın açıklaması.

sourceUri

string

Kanıtın URI konumu.

AttestationListResult

Kanıtlamaların listesi.

Name Tür Description
nextLink

string

Sonraki sonuç kümesini almak için URL.

value

Attestation[]

Kanıtlama tanımları dizisi.

ComplianceState

Kaynakta ayarlanması gereken uyumluluk durumu.

Name Tür Description
Compliant

string

Kaynak ilkeyle uyumlu.

NonCompliant

string

Kaynak ilkeyle uyumlu değil.

Unknown

string

Kaynağın uyumluluk durumu bilinmiyor.

createdByType

Kaynağı oluşturan kimliğin türü.

Name Tür Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDefinition

Hata tanımı.

Name Tür Description
additionalInfo

TypedErrorInfo[]

Senaryoya özgü ek hata ayrıntıları.

code

string

HTTP hata kodu için alt durum görevi gören hizmete özgü hata kodu.

details

ErrorDefinition[]

İç hata ayrıntıları.

message

string

Hatanın açıklaması.

target

string

Hatanın hedefi.

ErrorResponse

Hata yanıtı.

Name Tür Description
error

ErrorDefinition

Hata ayrıntıları.

systemData

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name Tür Description
createdAt

string

Kaynak oluşturma (UTC) zaman damgası.

createdBy

string

Kaynağı oluşturan kimlik.

createdByType

createdByType

Kaynağı oluşturan kimliğin türü.

lastModifiedAt

string

Kaynağın son değişikliğinin zaman damgası (UTC)

lastModifiedBy

string

Kaynağı en son değiştiren kimlik.

lastModifiedByType

createdByType

Kaynağı en son değiştiren kimliğin türü.

TypedErrorInfo

Senaryoya özgü hata ayrıntıları.

Name Tür Description
info

Senaryoya özgü hata ayrıntıları.

type

string

Eklenen hata ayrıntılarının türü.