本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 編輯 Amazon Security Lake 資源的標籤
<a name="tags-update"></a>

若要編輯 Amazon Security Lake 資源的標籤 （標籤索引鍵或標籤值），您可以使用 Security Lake 主控台或 Security Lake API。

**重要**  
編輯資源的標籤可能會影響對資源的存取。在編輯資源的標籤索引鍵或值之前，請檢閱可能使用標籤來控制資源存取的任何 AWS Identity and Access Management (IAM) 政策。

------
#### [ Console ]

請依照下列步驟，使用 Security Lake 主控台編輯資源的標籤。

**編輯資源的標籤**

1. 開啟位於 https：//[https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/) 的 Security Lake 主控台。

1. 根據您要編輯其標籤的資源類型，執行下列其中一項操作：
   + 對於資料湖組態，請在導覽窗格中選擇**區域**。然後，在**區域**表格中，選取區域。
   + 對於訂閱者，請在導覽窗格中選擇**訂閱者**。然後，在**我的訂閱者**資料表中，選取訂閱者。

     如果訂閱者未出現在資料表中，請使用頁面右上角的 AWS 區域 選取器來選取您建立訂閱者的區域。資料表只會列出目前區域的現有訂閱者。

1. 選擇**編輯**。

1. 展開 **Tags (標籤)** 區段。**標籤**區段會列出目前指派給資源的所有標籤。

1. 執行下列任何一項：
   + 若要將標籤值新增至現有的標籤索引鍵，請在標籤索引鍵旁的**值**方塊中輸入值。
   + 若要變更現有的標籤索引鍵，請選擇標籤旁的**移除**。然後選擇**新增標籤**。在出現的**金鑰**方塊中，輸入新的標籤金鑰。選擇性地在值方塊中輸入相關聯的標籤**值**。
   + 若要變更現有的標籤值，請在包含值**的值**方塊中選擇 **X**。然後在值方塊中輸入新的標籤**值**。
   + 若要移除現有的標籤值，請在包含值**的值**方塊中選擇 **X**。
   + 若要移除現有標籤 （包括標籤索引鍵和標籤值），請選擇標籤旁的**移除**。

   資源最多可以擁有 50 個標籤。標籤金鑰最多可包含 128 個字元。標籤值最多可包含 256 個字元。字元可以是字母、數字、空格或下列符號：\$1 . ： / = \$1 - @

1. 當您完成編輯標籤時，請選擇**儲存**。

------
#### [ API ]

當您以程式設計方式編輯資源的標籤時，會使用新值覆寫現有的標籤。因此，編輯標籤的最佳方式取決於您要編輯標籤索引鍵、標籤值或兩者。若要編輯標籤金鑰，[請移除目前的標籤](tags-remove.md)並[新增標籤](tags-add.md)。

若要編輯或僅移除與標籤金鑰相關聯的標籤值，請使用 Security Lake API 的 [TagResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_TagResource.html) 操作覆寫現有的值。如果您使用的是 AWS Command Line Interface (AWS CLI)，請執行 [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/tag-resource.html) 命令。在您的請求中，指定您要編輯或移除其標籤值之資源的 Amazon Resource Name (ARN)。

若要編輯標籤值，請使用 `tags` 參數來指定您要變更其標籤值的標籤索引鍵。同時指定金鑰的新標籤值。例如，下列 AWS CLI 命令`Cloud``On-Premises`會將指派給指定訂閱者的標籤金鑰的`Environment`標籤值從 變更為 。此範例已針對 Linux、macOS 或 Unix 格式化，並使用反斜線 (\$1) 行接續字元來改善可讀性。

```
$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Environment,value=On-Premises
```

其中：
+ `resource-arn` 指定訂閱者的 ARN。
+ `Environment` 是與要變更的標籤值相關聯的標籤索引鍵。
+ `On-Premises` 是指定標籤索引鍵 () 的新標籤值`Environment`。

若要從標籤索引鍵移除標籤值，請勿在 `tags` 參數中指定索引鍵`value`引數的值。例如：

```
$ aws securitylake tag-resource \
--resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab \
--tags key=Owner,value=
```

如果操作成功，Security Lake 會傳回空的 HTTP 200 回應。否則，Security Lake 會傳回 HTTP 4*xx* 或 500 回應，指出操作失敗的原因。

------

## 檢閱 Amazon Security Lake 資源的標籤
<a name="tags-retrieve"></a>

您可以使用 Security Lake 主控台或 Security Lake API 來檢閱 Amazon Security Lake 資源的標籤 （包括標籤索引鍵和標籤值）。

------
#### [ Console ]

請依照下列步驟，使用 Security Lake 主控台檢閱資源的標籤。

**檢閱資源的標籤**

1. 開啟位於 https：//[https://console.aws.amazon.com/securitylake/](https://console.aws.amazon.com/securitylake/) 的 Security Lake 主控台。

1. 根據您要檢閱其標籤的資源類型，執行下列其中一項操作：
   + 對於資料湖組態，請在導覽窗格中選擇**區域**。在**區域**表格中，選取區域，然後選擇**編輯**。然後展開**標籤**區段。
   + 對於訂閱者，請在導覽窗格中選擇**訂閱者**。然後，在**我的訂閱者**資料表中，選擇訂閱者的名稱。

     如果訂閱者未出現在資料表中，請使用頁面右上角的 AWS 區域 選取器來選取您建立訂閱者的區域。資料表只會列出目前區域的現有訂閱者。

**標籤**區段會列出目前指派給資源的所有標籤。

------
#### [ API ]

若要以程式設計方式擷取和檢閱現有資源的標籤，請使用 Security Lake API 的 [ListTagsForResource](https://docs.aws.amazon.com/security-lake/latest/APIReference/API_ListTagsForResource.html) 操作。在您的請求中，使用 `resourceArn` 參數來指定資源的 Amazon Resource Name (ARN)。

如果您使用的是 AWS Command Line Interface (AWS CLI)，請執行 [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/securitylake/list-tags-for-resource.html) 命令，並使用 `resource-arn` 參數來指定資源的 ARN。例如：

```
$ aws securitylake list-tags-for-resource --resource-arn arn:aws:securitylake:us-east-1:123456789012:subscriber/1234abcd-12ab-34cd-56ef-1234567890ab
```

在上述範例中，*arn：aws：securitylake：us-east-1：123456789012：subscriber/1234abcd-12ab-34cd-56ef-1234567890ab* 是現有訂閱者的 ARN。

如果操作成功，Security Lake 會傳回`tags`陣列。陣列中的每個物件都會指定目前指派給資源的標籤 （包括標籤索引鍵和標籤值）。例如：

```
{
    "tags": [
        {
            "key": "Environment",
            "value": "Cloud"
        },
        {
            "key": "CostCenter",
            "value": "12345"
        },
        {
            "key": "Owner",
            "value": ""
        }
    ]
}
```

其中 `Environment`、 `CostCenter`和 `Owner`是指派給資源的標籤金鑰。 `Cloud`是與標籤金鑰相關聯的`Environment`標籤值。 `12345`是與標籤金鑰相關聯的`CostCenter`標籤值。`Owner` 標籤索引鍵沒有相關聯的標籤值。

------