Sdílet prostřednictvím

Správa značek z právních důvodů

  • Článek

V tomto článku se dozvíte, jak spravovat právní značky v instanci Azure Data Manageru pro energii. Právní značka je entita, která představuje právní stav dat v instanci Azure Data Manageru pro energii. Značka Legal je kolekce vlastností, které řídí způsob ingestování a spotřeby dat. Pro příjem dat do vaší instance Azure Data Manageru pro energii se vyžaduje právní značka. Vyžaduje se také pro spotřebu dat z vaší instance Azure Data Manageru pro energii. Právní značky jsou definovány na úrovni datového oddílu jednotlivě.

Zatímco v Azure Data Manageru pro energetickou instanci definuje služba nároků přístup k datům pro daného uživatele, právní značka definuje celkový přístup k datům napříč uživateli. Uživatel může mít přístup ke správě dat v rámci datového oddílu, ale nemusí to udělat, dokud nebudou splněny určité právní požadavky.

Spuštěním následujícího příkazu curl v Azure Cloud Bash vytvořte právní značku pro daný oddíl dat vaší instance Azure Data Manageru pro energii.

    curl --location --request POST 'https://<URI>/api/legal/v1/legaltags' \
    --header 'data-partition-id: <data-partition-id>' \
    --header 'Authorization: Bearer <access_token>' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "name": "<legal-tag-name>",
        "description": "<legal-tag-description>",
        "properties": {
            "contractId": "<contract-id>",
            "countryOfOrigin": ["<country-of-origin>"],
            "dataType": "<data-type>",
            "expirationDate": "<expiration-ID>",
            "exportClassification": "<export-classification>",
            "originator": "<originator>",
            "personalData": "<personal-data>",
            "securityClassification": "Public"
        }
    }'

Ukázkový požadavek

Zvažte instanci Azure Data Manageru pro energii s názvem medstest s datovým oddílem s názvem dp1.

    curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
    --header 'data-partition-id: medstest-dp1' \
    --header 'Authorization: Bearer  eyxxxxxxx.........................' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "name": "medstest-dp1-legal-tag",
        "description": "Azure Data Manager for Energy Legal Tag",
        "properties": {
            "contractId": "A1234",
            "countryOfOrigin": ["US"],
            "dataType": "Public Domain Data",
            "expirationDate": "2099-01-25",
            "exportClassification": "EAR99",
            "originator": "MyCompany",
            "personalData": "No Personal Data",
            "securityClassification": "Public"
        }
    }'

Ukázková odpověď

    {
        "name": "medsStest-dp1-legal-tag",
        "description": "Azure Data Manager for Energy Legal Tag",
        "properties": {
        "countryOfOrigin": [
            "US"
        ],
        "contractId": "A1234",
        "expirationDate": "2099-01-25",
        "originator": "MyCompany",
        "dataType": "Public Domain Data",
        "securityClassification": "Public",
        "personalData": "No Personal Data",
        "exportClassification": "EAR99"
    }
}

Země původu by měla dodržovat formát ISO Alfa2.

Rozhraní API pro vytvoření právní značky interně připojí id oddílu dat k názvu právní značky, pokud ještě není k dispozici. Pokud má například požadavek název: legal-tag, pak by název vytvořit právní značku byl <instancename>-<data-partition-id>-legal-tag

    curl --location --request POST 'https://medstest.energy.azure.com/api/legal/v1/legaltags' \
    --header 'data-partition-id: medstest-dp1' \
    --header 'Authorization: Bearer  eyxxxxxxx.........................' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "name": "legal-tag",
        "description": "Azure Data Manager for Energy Legal Tag",
        "properties": {
            "contractId": "A1234",
            "countryOfOrigin": ["US"],
            "dataType": "Public Domain Data",
            "expirationDate": "2099-01-25",
            "exportClassification": "EAR99",
            "originator": "MyCompany",
            "personalData": "No Personal Data",
            "securityClassification": "Public"
        }
    }'

Ukázková odpověď bude mít připojené ID oddílu dat k názvu právní značky a ukázková odpověď bude:

    {
        "name": "medstest-dp1-legal-tag",
        "description": "Azure Data Manager for Energy Legal Tag",
        "properties": {
        "countryOfOrigin": [
            "US"
        ],
        "contractId": "A1234",
        "expirationDate": "2099-01-25",
        "originator": "MyCompany",
        "dataType": "Public Domain Data",
        "securityClassification": "Public",
        "personalData": "No Personal Data",
        "exportClassification": "EAR99"
    }
}

Spuštěním následujícího příkazu curl v Azure Cloud Bash získejte právní značku přidruženou k datovému oddílu vaší instance Azure Data Manageru pro energii.

    curl --location --request GET 'https://<URI>/api/legal/v1/legaltags/<legal-tag-name>' \
    --header 'data-partition-id: <data-partition-id>' \
    --header 'Authorization: Bearer <access_token>'

Ukázkový požadavek

Zvažte instanci Azure Data Manageru pro energii s názvem medstest s datovým oddílem s názvem dp1.

    curl --location --request GET 'https://medstest.energy.azure.com/api/legal/v1/legaltags/medstest-dp1-legal-tag' \
    --header 'data-partition-id: medstest-dp1' \
    --header 'Authorization: Bearer eyxxxxxxx.........................'

Ukázková odpověď

    {
    "name": "medstest-dp1-legal-tag",
    "description": "Azure Data Manager for Energy Legal Tag",
    "properties": {
        "countryOfOrigin": [
        "US"
        ],
        "contractId": "A1234",
        "expirationDate": "2099-01-25",
        "originator": "MyCompany",
        "dataType": "Public Domain Data",
        "securityClassification": "Public",
        "personalData": "No Personal Data",
        "exportClassification": "EAR99"
    }
    }

Další kroky

Přidání dalších datových oddílů