本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# DeleteSessions
<a name="DeleteSessions"></a>

删除指定的 Amazon DCV 会话，并将其从 Broker 的缓存中删除。

**Topics**
+ [请求参数](#request)
+ [响应参数](#response)
+ [示例](#example)

## 请求参数
<a name="request"></a>

**`SessionId`**  
要删除的会话的 ID。  
类型：字符串  
是否必需：是

**`Owner`**  
要删除的会话的所有者。  
类型：字符串  
是否必需：是

**`Force`**  
从 Broker 的缓存中删除会话，并尝试从 Amazon DCV 服务器中删除会话。这对于从 Broker 缓存中删除过时的会话非常有用。例如，如果 Amazon DCV 服务器已停止，但仍在 Broker 上注册会话，请使用该标记从 Broker 的缓存中清除会话。  
请记住，如果会话仍处于活动状态，Broker 将重新缓存会话。  
有效值：`true` \| `false`  
类型：布尔值  
必需：否

## 响应参数
<a name="response"></a>

**`SessionId`**  
会话 ID

**`State`**  
仅在成功删除会话时返回。指示会话的当前状态。如果请求成功完成，会话将转变为 `DELETING` 状态。删除会话可能需要几分钟的时间。在已删除会话后，状态将从 `DELETING` 转变为 `DELETED`。

**`FailureReason`**  
仅在无法删除某些会话时返回。指示无法删除会话的原因。

## 示例
<a name="example"></a>

------
#### [ Python ]

**请求**  
以下示例删除两个会话 - 一个会话由 `user1` 拥有并具有 ID `SessionId123`，另一个会话由 `user99` 拥有并具有 ID `SessionIdabc`。

```
from swagger_client.models.delete_session_request_data import DeleteSessionRequestData

def get_sessions_api():
    api_instance = swagger_client.SessionsApi(swagger_client.ApiClient(get_client_configuration()))
    set_request_headers(api_instance.api_client)
    return api_instance

def delete_sessions(sessions_to_delete, force=False):
    delete_sessions_request = list()
    for session_id, owner in sessions_to_delete:
        a_request = DeleteSessionRequestData(session_id=session_id, owner=owner, force=force)
        delete_sessions_request.append(a_request)

    print('Delete Sessions Request:', delete_sessions_request)
    api_instance = get_sessions_api()
    api_response = api_instance.delete_sessions(body=delete_sessions_request)
    print('Delete Sessions Response', api_response)

def main():
    delete_sessions([('SessionId123', 'an owner user1'), ('SessionIdabc', 'user99')])
```

**响应**  
以下是示例输出。已成功删除 `SessionId123`，但无法删除 `SessionIdabc`。

```
{
    "RequestId": "10311636-df90-4cd1-bcf7-474e9675b7cd",
    "SuccessfulList": [
        {
            "SessionId": "SessionId123",
            "State": "DELETING"
        }
    ],
    "UnsuccessfulList": [
        {
            "SessionId": "SessionIdabc",
            "FailureReason": "The requested dcvSession does not exist"
        }
    ]
}
```

------