Full name: projects.locations.instances.dataAccessLabels.create
Creates a data access label. Data access labels are applied to incoming event data and selected in data access scopes (another resource), and only users with scopes containing the label can see data with that label. Currently, the data access label resource only includes custom labels, which are labels that correspond to UDM queries over event data.
HTTP request
Path parameters
Parameters
parent
string
Required. The parent resource where this Data Access Label will be created. Format: projects/{project}/locations/{location}/instances/{instance}
Query parameters
Parameters
dataAccessLabelId
string
Required. The ID to use for the data access label, which will become the label's display name and the final component of the label's resource name. The maximum number of characters should be 63. Regex pattern is as per AIP: https://google.aip.dev/122#resource-id-segments
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis webpage details how to create a data access label using the \u003ccode\u003eprojects.locations.instances.dataAccessLabels.create\u003c/code\u003e method, which is used to control data visibility for users.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request for creating a data access label is a \u003ccode\u003ePOST\u003c/code\u003e request to the specified URL: \u003ccode\u003ehttps://chronicle.googleapis.com/v1alpha/{parent}/dataAccessLabels\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter, a required string, identifies where to create the label and follows the format: \u003ccode\u003eprojects/{project}/locations/{location}/instances/{instance}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edataAccessLabelId\u003c/code\u003e query parameter, also a required string, specifies the label's display name and must follow a maximum character count of 63 and a specific regex pattern.\u003c/p\u003e\n"],["\u003cp\u003eThe request body and response body uses the \u003ccode\u003eDataAccessLabel\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,["# Method: dataAccessLabels.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\n**Full name**: projects.locations.instances.dataAccessLabels.create\n\nCreates a data access label. Data access labels are applied to incoming event data and selected in data access scopes (another resource), and only users with scopes containing the label can see data with that label. Currently, the data access label resource only includes custom labels, which are labels that correspond to UDM queries over event data.\n\n### HTTP request\n\nChoose a location: \nafrica-south1 asia-northeast1 asia-south1 asia-southeast1 asia-southeast2 australia-southeast1 europe-west12 europe-west2 europe-west3 europe-west6 europe-west9 me-central1 me-central2 me-west1 northamerica-northeast2 southamerica-east1 us eu \n\n\u003cbr /\u003e\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [DataAccessLabel](/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.dataAccessLabels#DataAccessLabel).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [DataAccessLabel](/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.dataAccessLabels#DataAccessLabel).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `chronicle.dataAccessLabels.create`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]