# Argo

# Smart Routing

## Get Argo Smart Routing setting

`argo.smart_routing.get(SmartRoutingGetParams**kwargs)  -> SmartRoutingGetResponse`

**get** `/zones/{zone_id}/argo/smart_routing`

Retrieves the value of Argo Smart Routing enablement setting.

### Parameters

- `zone_id: str`

  Specifies the zone associated with the API call.

### Returns

- `class SmartRoutingGetResponse: …`

  - `id: str`

    Specifies the identifier of the Argo Smart Routing setting.

  - `editable: bool`

    Specifies if the setting is editable.

  - `value: Literal["on", "off"]`

    Specifies the enablement value of Argo Smart Routing.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Specifies the time when the setting was last modified.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
smart_routing = client.argo.smart_routing.get(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
)
print(smart_routing.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "id",
    "editable": true,
    "value": "on",
    "modified_on": "2019-12-27T18:11:19.117Z"
  },
  "success": true
}
```

## Patch Argo Smart Routing setting

`argo.smart_routing.edit(SmartRoutingEditParams**kwargs)  -> SmartRoutingEditResponse`

**patch** `/zones/{zone_id}/argo/smart_routing`

Configures the value of the Argo Smart Routing enablement setting.

### Parameters

- `zone_id: str`

  Specifies the zone associated with the API call.

- `value: Literal["on", "off"]`

  Specifies the enablement value of Argo Smart Routing.

  - `"on"`

  - `"off"`

### Returns

- `class SmartRoutingEditResponse: …`

  - `id: str`

    Specifies the identifier of the Argo Smart Routing setting.

  - `editable: bool`

    Specifies if the setting is editable.

  - `value: Literal["on", "off"]`

    Specifies the enablement value of Argo Smart Routing.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Specifies the time when the setting was last modified.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.argo.smart_routing.edit(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    value="on",
)
print(response.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "id": "id",
    "editable": true,
    "value": "on",
    "modified_on": "2019-12-27T18:11:19.117Z"
  },
  "success": true
}
```

## Domain Types

### Smart Routing Get Response

- `class SmartRoutingGetResponse: …`

  - `id: str`

    Specifies the identifier of the Argo Smart Routing setting.

  - `editable: bool`

    Specifies if the setting is editable.

  - `value: Literal["on", "off"]`

    Specifies the enablement value of Argo Smart Routing.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Specifies the time when the setting was last modified.

### Smart Routing Edit Response

- `class SmartRoutingEditResponse: …`

  - `id: str`

    Specifies the identifier of the Argo Smart Routing setting.

  - `editable: bool`

    Specifies if the setting is editable.

  - `value: Literal["on", "off"]`

    Specifies the enablement value of Argo Smart Routing.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Specifies the time when the setting was last modified.

# Tiered Caching

## Get Tiered Caching setting

`argo.tiered_caching.get(TieredCachingGetParams**kwargs)  -> TieredCachingGetResponse`

**get** `/zones/{zone_id}/argo/tiered_caching`

Tiered Cache works by dividing Cloudflare's data centers into a hierarchy of lower-tiers and upper-tiers. If content is not cached in lower-tier data centers (generally the ones closest to a visitor), the lower-tier must ask an upper-tier to see if it has the content. If the upper-tier does not have the content, only the upper-tier can ask the origin for content. This practice improves bandwidth efficiency by limiting the number of data centers that can ask the origin for content, which reduces origin load and makes websites more cost-effective to operate. Additionally, Tiered Cache concentrates connections to origin servers so they come from a small number of data centers rather than the full set of network locations. This results in fewer open connections using server resources.

### Parameters

- `zone_id: str`

  Identifier.

### Returns

- `class TieredCachingGetResponse: …`

  - `id: Literal["tiered_caching"]`

    The identifier of the caching setting.

    - `"tiered_caching"`

  - `editable: bool`

    Whether the setting is editable.

  - `value: Literal["on", "off"]`

    Value of the Tiered Cache zone setting.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Last time this setting was modified.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
tiered_caching = client.argo.tiered_caching.get(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
)
print(tiered_caching.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "id": "tiered_caching",
    "editable": true,
    "value": "on",
    "modified_on": "2014-01-01T05:20:00.12345Z"
  }
}
```

## Patch Tiered Caching setting

`argo.tiered_caching.edit(TieredCachingEditParams**kwargs)  -> TieredCachingEditResponse`

**patch** `/zones/{zone_id}/argo/tiered_caching`

Tiered Cache works by dividing Cloudflare's data centers into a hierarchy of lower-tiers and upper-tiers. If content is not cached in lower-tier data centers (generally the ones closest to a visitor), the lower-tier must ask an upper-tier to see if it has the content. If the upper-tier does not have the content, only the upper-tier can ask the origin for content. This practice improves bandwidth efficiency by limiting the number of data centers that can ask the origin for content, which reduces origin load and makes websites more cost-effective to operate. Additionally, Tiered Cache concentrates connections to origin servers so they come from a small number of data centers rather than the full set of network locations. This results in fewer open connections using server resources.

### Parameters

- `zone_id: str`

  Identifier.

- `value: Literal["on", "off"]`

  Enables Tiered Caching.

  - `"on"`

  - `"off"`

### Returns

- `class TieredCachingEditResponse: …`

  - `id: Literal["tiered_caching"]`

    The identifier of the caching setting.

    - `"tiered_caching"`

  - `editable: bool`

    Whether the setting is editable.

  - `value: Literal["on", "off"]`

    Value of the Tiered Cache zone setting.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Last time this setting was modified.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.argo.tiered_caching.edit(
    zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    value="on",
)
print(response.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "id": "tiered_caching",
    "editable": true,
    "value": "on",
    "modified_on": "2014-01-01T05:20:00.12345Z"
  }
}
```

## Domain Types

### Tiered Caching Get Response

- `class TieredCachingGetResponse: …`

  - `id: Literal["tiered_caching"]`

    The identifier of the caching setting.

    - `"tiered_caching"`

  - `editable: bool`

    Whether the setting is editable.

  - `value: Literal["on", "off"]`

    Value of the Tiered Cache zone setting.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Last time this setting was modified.

### Tiered Caching Edit Response

- `class TieredCachingEditResponse: …`

  - `id: Literal["tiered_caching"]`

    The identifier of the caching setting.

    - `"tiered_caching"`

  - `editable: bool`

    Whether the setting is editable.

  - `value: Literal["on", "off"]`

    Value of the Tiered Cache zone setting.

    - `"on"`

    - `"off"`

  - `modified_on: Optional[datetime]`

    Last time this setting was modified.