Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administración de las invalidaciones de Amazon CloudFront mediante la API de CloudFront y la versión 3 de AWS SDK para PHP
Amazon CloudFront almacena en caché copias de archivos estáticos y dinámicos en ubicaciones periféricas en todo el mundo. Para eliminar o actualizar un archivo en todas las ubicaciones de borde, cree una invalidación para cada archivo o para un grupo de archivos.
Cada mes, sus primeras 1000 invalidaciones son gratuitas. Para obtener más información acerca de cómo eliminar contenido de una ubicación periférica de CloudFront, consulte [Invalidar archivos](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Invalidation.html).
Los siguientes ejemplos muestran cómo:
+ Crear una invalidación de una distribución con [CreateInvalidation](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloudfront-2018-11-05.html#createinvalidation).
+ Obtener una invalidación de una distribución con [GetInvalidation](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloudfront-2018-11-05.html#getinvalidation).
+ Obtener una lista de invalidaciones de distribuciones con [ListInvalidations](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloudfront-2018-11-05.html#listinvalidations).
Todo el código de ejemplo de AWS SDK para PHP está disponible [aquí en GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code).
## Credenciales
Antes de ejecutar el código de ejemplo, configure sus credenciales de AWS, como se indica en [Autenticación AWS con la AWS SDK para PHP versión 3](credentials.md). A continuación, importe AWS SDK para PHP, como se indica en [Instalación de la AWS SDK para PHP versión 3](getting-started_installation.md).
Para obtener más información sobre el uso de Amazon CloudFront, consulte la [Guía para desarrolladores de Amazon CloudFront](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/).
## Creación de una invalidación de una distribución
Para crear una invalidación de una distribución de , especifique la ubicación de la ruta de los archivos que necesita eliminar. Este ejemplo invalida todos los archivos de la distribución, pero puede identificar archivos específicos en `Items`.
Para crear una invalidación de una distribución de CloudFront, utilice la operación [CreateInvalidation](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateInvalidation.html).
**Importaciones**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de muestra**
```
function createInvalidation(
$cloudFrontClient,
$distributionId,
$callerReference,
$paths,
$quantity
) {
try {
$result = $cloudFrontClient->createInvalidation([
'DistributionId' => $distributionId,
'InvalidationBatch' => [
'CallerReference' => $callerReference,
'Paths' => [
'Items' => $paths,
'Quantity' => $quantity,
],
]
]);
$message = '';
if (isset($result['Location'])) {
$message = 'The invalidation location is: ' . $result['Location'];
}
$message .= ' and the effective URI is ' . $result['@metadata']['effectiveUri'] . '.';
return $message;
} catch (AwsException $e) {
return 'Error: ' . $e->getAwsErrorMessage();
}
}
function createTheInvalidation()
{
$distributionId = 'E17G7YNEXAMPLE';
$callerReference = 'my-unique-value';
$paths = ['/*'];
$quantity = 1;
$cloudFrontClient = new Aws\CloudFront\CloudFrontClient([
'profile' => 'default',
'version' => '2018-06-18',
'region' => 'us-east-1'
]);
echo createInvalidation(
$cloudFrontClient,
$distributionId,
$callerReference,
$paths,
$quantity
);
}
// Uncomment the following line to run this code in an AWS account.
// createTheInvalidation();
```
## Obtención de una invalidación de una distribución
Para recuperar el estado y los detalles de una invalidación de una distribución de CloudFront, utilice la operación [GetInvalidation](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetInvalidation.html).
**Importaciones**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de muestra**
```
function getInvalidation($cloudFrontClient, $distributionId, $invalidationId)
{
try {
$result = $cloudFrontClient->getInvalidation([
'DistributionId' => $distributionId,
'Id' => $invalidationId,
]);
$message = '';
if (isset($result['Invalidation']['Status'])) {
$message = 'The status for the invalidation with the ID of ' .
$result['Invalidation']['Id'] . ' is ' .
$result['Invalidation']['Status'];
}
if (isset($result['@metadata']['effectiveUri'])) {
$message .= ', and the effective URI is ' .
$result['@metadata']['effectiveUri'] . '.';
} else {
$message = 'Error: Could not get information about ' .
'the invalidation. The invalidation\'s status ' .
'was not available.';
}
return $message;
} catch (AwsException $e) {
return 'Error: ' . $e->getAwsErrorMessage();
}
}
function getsAnInvalidation()
{
$distributionId = 'E1BTGP2EXAMPLE';
$invalidationId = 'I1CDEZZEXAMPLE';
$cloudFrontClient = new Aws\CloudFront\CloudFrontClient([
'profile' => 'default',
'version' => '2018-06-18',
'region' => 'us-east-1'
]);
echo getInvalidation($cloudFrontClient, $distributionId, $invalidationId);
}
// Uncomment the following line to run this code in an AWS account.
// getsAnInvalidation();
```
## Listado de las invalidaciones de una distribución
Para obtener una lista de todas las invalidaciones actuales de una distribución de CloudFront, utilice la operación [ListInvalidations](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListInvalidations.html).
**Importaciones**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de muestra**
```
function listInvalidations($cloudFrontClient, $distributionId)
{
try {
$result = $cloudFrontClient->listInvalidations([
'DistributionId' => $distributionId
]);
return $result;
} catch (AwsException $e) {
exit('Error: ' . $e->getAwsErrorMessage());
}
}
function listTheInvalidations()
{
$distributionId = 'E1WICG1EXAMPLE';
$cloudFrontClient = new Aws\CloudFront\CloudFrontClient([
'profile' => 'default',
'version' => '2018-06-18',
'region' => 'us-east-1'
]);
$invalidations = listInvalidations(
$cloudFrontClient,
$distributionId
);
if (isset($invalidations['InvalidationList'])) {
if ($invalidations['InvalidationList']['Quantity'] > 0) {
foreach ($invalidations['InvalidationList']['Items'] as $invalidation) {
echo 'The invalidation with the ID of ' . $invalidation['Id'] .
' has the status of ' . $invalidation['Status'] . '.' . "\n";
}
} else {
echo 'Could not find any invalidations for the specified distribution.';
}
} else {
echo 'Error: Could not get invalidation information. Could not get ' .
'information about the specified distribution.';
}
}
// Uncomment the following line to run this code in an AWS account.
// listTheInvalidations();
```