Workbooks - Revisions List

Referencia

Service:: Application Insights

API Version:: 2021-08-01

Obtenga las revisiones del libro definidas por su resourceName.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/workbooks/{resourceName}/revisions?api-version=2021-08-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
resourceName	path	True	string	Nombre del recurso de componente de Application Insights.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
api-version	query	True	string	Versión de API que se usará para la operación.

Respuestas

Nombre	Tipo	Description
200 OK	WorkbooksListResult	Lista que contiene 0 o más definiciones de libro.
Other Status Codes	WorkbookError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

WorkbookRevisionsList

Sample Request

GET https://management.azure.com/subscriptions/6b643656-33eb-422f-aee8-3ac145d124af/resourceGroups/my-resource-group/providers/Microsoft.Insights/workbooks/deadb33f-5e0d-4064-8ebb-1a4ed0313eb2/revisions?api-version=2021-08-01

import com.azure.core.util.Context;

/** Samples for Workbooks RevisionsList. */
public final class Main {
    /*
     * x-ms-original-file: specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2021-08-01/examples/WorkbookRevisionsList.json
     */
    /**
     * Sample code: WorkbookRevisionsList.
     *
     * @param manager Entry point to ApplicationInsightsManager.
     */
    public static void workbookRevisionsList(
        com.azure.resourcemanager.applicationinsights.ApplicationInsightsManager manager) {
        manager.workbooks().revisionsList("my-resource-group", "deadb33f-5e0d-4064-8ebb-1a4ed0313eb2", 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 armapplicationinsights_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/applicationinsights/armapplicationinsights"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/applicationinsights/resource-manager/Microsoft.Insights/stable/2021-08-01/examples/WorkbookRevisionsList.json
func ExampleWorkbooksClient_NewRevisionsListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armapplicationinsights.NewWorkbooksClient("6b643656-33eb-422f-aee8-3ac145d124af", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := client.NewRevisionsListPager("my-resource-group",
		"deadb33f-5e0d-4064-8ebb-1a4ed0313eb2",
		nil)
	for pager.More() {
		nextResult, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range nextResult.Value {
			// TODO: use page item
			_ = v
		}
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/6b643656-33eb-422f-aee8-3ac145d124af/resourcegroups/my-resource-group/providers/Microsoft.Insights/workbooks/deadb33f-5e0d-4064-8ebb-1a4ed0313eb2",
      "name": "deadb33f-5e0d-4064-8ebb-1a4ed0313eb2",
      "type": "Microsoft.Insights/workbooks",
      "location": "westus",
      "tags": {},
      "kind": "shared",
      "properties": {
        "displayName": "My Workbook 1",
        "userId": "userId",
        "sourceId": "Azure Monitor",
        "serializedData": null,
        "version": "Notebook/1.0",
        "category": "workbook",
        "timeModified": "2020-09-04T09:07:17.735638Z",
        "storageUri": null,
        "description": "Sample workbook",
        "revision": "1e2f8435b98248febee70c64ac22e1ab"
      }
    },
    {
      "id": "/subscriptions/6b643656-33eb-422f-aee8-3ac145d124af/resourcegroups/my-resource-group/providers/Microsoft.Insights/workbooks/deadb33f-5e0d-4064-8ebb-1a4ed0313eb2",
      "name": "deadb33f-5e0d-4064-8ebb-1a4ed0313eb2",
      "type": "Microsoft.Insights/workbooks",
      "location": "westus",
      "tags": {
        "TagSample01": "sample01",
        "TagSample02": "sample02"
      },
      "kind": "shared",
      "properties": {
        "displayName": "My Workbook 2",
        "userId": "userId",
        "sourceId": "Azure Monitor",
        "serializedData": null,
        "version": "Notebook/1.0",
        "category": "workbook",
        "timeModified": "2020-08-04T09:07:17.735638Z",
        "storageUri": null,
        "description": "Sample workbook",
        "revision": "1e2f8435b98248febee70c64ac22e1bb"
      }
    }
  ],
  "nextLink": null
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
Identity	Identidad usada para BYOS
kind	Tipo de libro. Solo se comparte el valor válido.
ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
systemData	Metadatos relacionados con la creación y la última modificación del recurso.
UserAssignedIdentity	Propiedades de identidad asignadas por el usuario
Workbook	Definición de libro de Application Insights.
WorkbookError	Respuesta de error.
WorkbookErrorDefinition	Definición de error.
WorkbookInnerErrorTrace	Detalles del error
WorkbooksListResult	Resultado de la lista de libros.

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Identity

Identidad usada para BYOS

Nombre	Tipo	Description
principalId	string	Identificador de la entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId	string	Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identidades de User-Assigned Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves del diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

kind

Tipo de libro. Solo se comparte el valor válido.

Nombre	Tipo	Description
shared	string
user	string

ManagedServiceIdentityType

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Nombre	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre	Tipo	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad asignada.
principalId	string	Identificador de entidad de seguridad de la identidad asignada.

Workbook

Definición de libro de Application Insights.

Nombre	Tipo	Description
etag	object	ETAG de recursos
id	string	Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity	Identidad usada para BYOS
kind	kind	Tipo de libro. Solo se comparte el valor válido.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso.
properties.category	string	Categoría del libro, según lo definido por el usuario en el momento de la creación.
properties.description	string	Descripción del libro.
properties.displayName	string	Nombre definido por el usuario (nombre para mostrar) del libro.
properties.revision	string	Identificador de revisión único para esta definición de libro
properties.serializedData	string	Configuración de este libro en particular. Los datos de configuración son una cadena que contiene JSON válido
properties.sourceId	string	ResourceId para un recurso de origen.
properties.storageUri	string	ResourceId a la cuenta de almacenamiento cuando se usa Bring Your Own Storage.
properties.tags	string[]	En desuso, use el otro campo de etiquetas.
properties.timeModified	string	Fecha y hora en UTC de la última modificación realizada en esta definición de libro.
properties.userId	string	Identificador de usuario único del usuario específico que posee este libro.
properties.version	string	Formato de versión del esquema del libro, como "Notebook/1.0", que debe coincidir con el libro en serializedData
systemData	systemData	Metadatos relacionados con la creación y la última modificación del recurso.
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

WorkbookError

Respuesta de error.

Nombre	Tipo	Description
error	WorkbookErrorDefinition	Los detalles del error.

WorkbookErrorDefinition

Definición de error.

Nombre	Tipo	Description
code	string	Código de error específico del servicio que actúa como subestado para el código de error HTTP.
innererror	WorkbookInnerErrorTrace	Detalles internos del error.
message	string	Descripción del error.

WorkbookInnerErrorTrace

Detalles del error

Nombre	Tipo	Description
trace	string[]	seguimiento de errores detallado

WorkbooksListResult

Resultado de la lista de libros.

Nombre	Tipo	Description
nextLink	string
value	Workbook[]	Matriz de libros.