Skip to main content
API · Discovery POST /api/v1/discovery-sources/{discoverySourceUuid}/catalog:import Requires the GV.APIContributor application role, or a higher role (Owner > Contributor > Reader). Operation ID · import_discovery_source_catalog_items

​
Request example

​
Authentication and access

  • Required role: GV.APIContributor
  • Data classification: metadata
  • Side effects: configurationWrite, customerCompute
Use an authentication scheme declared below. Ordinary workloads use application tokens; signed-in users use delegated tokens and Organization membership. Activation and invitation acceptance require a person, and execution callbacks require their registered identity.
  • Microsoft Entra delegated user token
  • Microsoft Entra application token

​
Parameters

​
discoverySourceUuid

path Required Opaque Discovery Source UUID. string (uuid) Opaque Discovery Source UUID.

​
Idempotency-Key

header Required Required caller-chosen retry identity. Use 1-128 visible ASCII characters and reuse it only for an exact retry of this request. string minimum length: 1 · maximum length: 128

​
Request body

Required

​
application/json

Schema CloudDiscoveryCatalogImportRequest object Import opaque items from the exact catalog snapshot the user reviewed. Properties catalogDigest— Required string Digest returned with the exact cloud catalog snapshot being imported. pattern: ^sha256:[0-9a-f]{64}$ catalogItemUuids— Required array<string (uuid)> Opaque item UUIDs from the reviewed cloud catalog snapshot. minimum items: 1 · maximum items: 100 Array items string (uuid) Additional properties are not allowed. Schema example
Examples Import from the exact snapshot shown to the caller · reviewedSnapshot

​
Responses

This guide summarizes response status codes and headers. Retrieve the deployed, authenticated OpenAPI document for the exact response body schemas and examples. The API also provides an authenticated Swagger UI; opening it in a browser does not automatically attach a bearer token. Error responses use application/problem+json. The response’s stable code and type map to the error-code reference.

​
200

Per-item import outcomes from the reviewed cloud snapshot.

​
Headers

  • Idempotency-Replayed: boolean
  • Location: string

​
401

A valid Microsoft Entra bearer token is required.

​
402

The organization entitlement does not permit this mutation.

​
403

The authenticated principal does not have the required role.

​
404

The resource does not exist in this tenant.

​
409

The operation conflicts with current resource or Azure state.

​
412

If-Match did not match the resource’s current strong ETag.

​
422

The request is syntactically valid but semantically invalid.

​
429

The bounded application request rate was exceeded.

​
Headers

  • Retry-After: Seconds to wait before retrying. integerminimum: 1

​
503

A required dependency is temporarily unavailable.

​
Headers

  • Retry-After: Seconds to wait before retrying. integerminimum: 1