List Azure accounts

GET  /azure/account

Overview

List all Azure accounts linked to your Cloudcraft account.

The response is an array of Azure accounts. Each entry includes the account ID and name, access control, and user information.

The provided account IDs are required to access the other Azure-related APIs.

応答

OK

Unauthorized

コード例

curl --location 'https://api.cloudcraft.co/azure/account'

Add an Azure account

POST  /azure/account

Overview

Register a new Azure account with Cloudcraft.

The body of the request should contain the account properties in JSON format. The response contains the created account object, including the newly assigned ID for use with other API endpoints.

Properties

  • name: A human-readable name for the Azure account. For example, “Production” or “Staging”.
  • subscriptionId: Subscription ID of your Azure account.
  • directoryId: Azure Tenant or Directory ID.
  • applicationId: Identifier of the application registered with Azure
  • clientSecret: Client secret associated with the registered application.

応答

OK

Expand All

フィールド

種類

説明

CreatorId

string

The user ID of the creator of the Azure account.

applicationId

string

Identifier of the application registered with Azure.

createdAt

string

The date and time the Azure account was created.

directoryId

string

The Azure Tenant or Directory ID.

id

string

The unique identifier of the Azure account.

name

string

A human-readable name for the Azure account.

subscriptionId

string

Subscription ID of the Azure account.

updatedAt

string

The date and time the Azure account was last updated.

{
  "CreatorId": "us46e9aa-5806-4cd6-8e78-c22d58602d09",
  "applicationId": "azapp737-4763-4fc4-9d2b-c5f4d07d22df",
  "createdAt": "2022-01-01T21:18:59.057Z",
  "directoryId": "azdirc44-0230-4732-9e70-cc00736f0a97",
  "id": "azfda35c-82fe-4edf-b9e9-ffd48f041c22",
  "name": "Development",
  "subscriptionId": "azsub827-5f07-45ce-8f2b-6c5001db5c6f",
  "updatedAt": "2022-01-01T21:19:03.487Z"
}

Unauthorized

Forbidden, insufficient privileges

コード例

curl --location 'https://api.cloudcraft.co/azure/account' \
--header 'Content-Type: application/json' \
--data '{"applicationId": "azapp737-4763-4fc4-9d2b-c5f4d07d22df",
"clientSecret": "secret~AIaxaBYlVBkbBhJIqhP9iXgh4c1jpdyaa9",
"directoryId": "azdirc44-0230-4732-9e70-cc00736f0a97",
"name": "Development",
"subscriptionId": "azsub827-5f07-45ce-8f2b-6c5001db5c6f",
}'

Delete an Azure account

DELETE  /azure/account/{account_id}

Overview

Delete a registered Azure account.

Path Parameters

  • account_id: UUID. Azure account ID. Required.

応答

No Content

Unauthorized

Forbidden, insufficient privileges

Azure account not found

コード例

curl --location --request DELETE 'https://api.cloudcraft.co/azure/account/{account_id}'

Update an Azure account

PUT  /azure/account/{account_id}

Overview

Update an Azure account registered in Cloudcraft.

The body of the request should contain the account properties in JSON format. The response contains the updated account object.

Path Parameters

  • account_id: UUID. Azure account ID. Required.

Properties

  • name: A human-readable name for the Azure account. For example, “Production” or “Staging”.
  • subscriptionId: Subscription ID of your Azure account.
  • directoryId: Azure Tenant or Directory ID.
  • applicationId: Identifier of the application registered with Azure.
  • clientSecret: Client secret associated with the registered application.

応答

OK

Unauthorized

Forbidden, insufficient privileges

コード例

curl --location --request PUT 'https://api.cloudcraft.co/azure/account/{account_id}' \
--data '{"applicationId": "azapp737-4763-4fc4-9d2b-c5f4d07d22df",
"clientSecret": "secret~AIaxaBYlVBkbBhJIqhP9iXgh4c1jpdyaa9",
"directoryId": "azdirc44-0230-4732-9e70-cc00736f0a97",
"name": "Development123",
"subscriptionId": "azsub827-5f07-45ce-8f2b-6c5001db5c6f",
}'

Snapshot an Azure account

GET  /azure/account/{account_id}/{region}/{format}

Overview

Scan and render one region of an Azure account into a blueprint in JSON, SVG, PNG, PDF, or MxGraph format.

The time required to generate the snapshot depends on the number of resources in the Azure region.

The API behaves as a long poll, with a wait time of up to 120 seconds for the result. For most
environments, the API call returns a blueprint. If
the wait time is exceeded, a 202 Accepted response is returned with a
{code: STILL_PROCESSING, retry: true ...} JSON body. The snapshot will continue processing in the background, and a retry will either immediately return the result or continue waiting.

Path Parameters

  • account_id: UUID. Azure Account ID as registered with Cloudcraft.
  • region: String. Azure region, for example, “eastus”.
  • format: String. One of “json”, “svg”, “png”, “pdf”, or “mxGraph”.

Optional query parameters

  • filter: String. Render a subset of the Azure account. Accepts a filter expression as used on the Live tab in the web application. The filter expression terms must be separated by spaces. The terms are substrings to be matched, key-value pairs, logical operators, or parentheses. For example, `env=dev OR env=test`.
  • exclude: List of Strings. Exclude Azure services by name. For example, “azurevmss,azurensg” to exclude both Virtual Machine Scale Set and Network Security Groups. The service value is specified by the “type” field of Blueprint components.
  • label: Boolean. Automatically label all components. Defaults to true.
  • autoconnect: Boolean. Automatically connect all components. Defaults to true.
  • scale: Float. Scale relative to original size (1.0), for example, 0.5 for half or 2.0 for double size.
  • width: Number. Image width in pixels (for SVG, PNG, and PDF).
  • height: Number. Image height in pixels (for SVG, PNG, and PDF).
  • grid: Boolean. Enable or disable grid rendering.
  • transparent: Boolean. Enable or disable transparent background rendering.
  • landscape: Boolean. Enable or disable landscape paper format (PDF).
  • paperSize: String. Applies when the format is PDF. One of “Letter”, “Legal”, “Tabloid”, “Ledger”, “A0”, “A1”, “A2”, “A3”, “A4”, “A5”.
  • projection: String. The visual style of the diagram. One of “isometric” or “2d”.
  • theme: String. The color theme of the diagram. One of “light” or “dark”.

応答

OK

Wait time exceeded

Expand All

フィールド

種類

説明

code

string

 

message

string

 

retry

boolean

 

{
  "code": "STILL_PROCESSING",
  "message": "Result wait time exceeded. Processing continues in the background, retry to receive result.",
  "retry": true
}

Unauthorized

Forbidden, insufficient privileges

Azure account not found

コード例

curl --location 'https://api.cloudcraft.co/azure/account/{account_id}/{region}/{format}'

PREVIEWING: aliciascott/DOCS-9725-Cloudcraft